Knowledge Base

Documentation to help you use the POEditor localization platform effectively

How to use webhooks in your localization project

Owner

Webhooks are available starting with the Premium plan.

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.

How to create a webhook

In the integration page of your code hosting service of choice, you can find a webhook generator, where you can choose the desired action(s) for your webhook.

Webhooks generator - POEditor localization management platform

Any import or export rule set for a linked language in the integration page will be inherited by its corresponding webhook.

How to call a webhook

Webhooks can be called from anywhere. They can be added in your repo's settings, to be called by one or more events taking place in the repo at a given time.

If the webhook is added to your repo, its operations will take effect every time the selected event takes place, regardless of the branch determining the event.

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

The export option can be triggered from anywhere, except from your repo's settings (to avoid a loop).

Linking multiple files to a language

You can connect multiple files to the same language by creating a link for each of these files. If you want to run an operation for all the linked files via webhooks, you need to create a webhook with this operation and run it for each of the linked files.

We strongly recommend that you do not use the sync webhook if you have multiple files linked to the source language. The sync webhook deletes the terms which are in the project, but are not in the connected file. So you may end up losing terms you imported from other files. The terms from the file last synced is what remains in your POEditor project.

Webhooks log

As a POEditor user, you can see what actions have been triggered in your account using webhooks, by going to Account Settings > Logs > Webhooks Log.

Additional help

Related articles