Knowledge Base

Documentation on how to translate software with POEditor

Webhooks are user-defined HTTP callbacks, which can be maintained, modified and managed by any third-party users, in order to cause events on one site to invoke behavior on another.

Webhooks can be called from anywhere. They can be added in a Bitbucket repo's settings, to extend what Bitbucket does when the repository changes (for example, new code is pushed or a pull request is merged).

When the webhook is triggered, the assigned languages/projects on POEditor receive data from the Bitbucket file that is connected to it.

URL Example

https://poeditor.com/api/webhooks/bitbucket?api_token=a9824103d8729b923fbe1d268ec69ef9&id_project=7717&language=en&operation=import_translations

  • api_token (required) - you can get this key from your POEditor account. You'll find it in My Account > API Access.
  • id_project (required) - the id of project. You'll find it in My Account > API Access.
  • language (required) - language code. You'll find it in My Account > API Access.
  • operation (required) - can be one of the following:
    • get_terms - import new terms
    • import_translations - import translations
    • import_terms_and_translations - import new terms and translations
    • sync_terms_and_translations - sync terms and translations
  • overwrite_translations (optional) - when importing translations, set it to 1 in order to overwrite existing translations

In the Bitbucket integration page, you can find a webhook generator.