Webhooks allow you to receive information about the key events that happen in your Crowdin project, like completed translations or proofreading. Після того як ви налаштуєте вебхук для проєкту, Crowdin почне надсилати запити POST або GET із даними на URL-адресу вебхуку через HTTP.

Зареєструвати вебхук можуть лише власники та керівники проєктів.

Варіанти використання

You can add webhooks to build integrations with the services or with your backend. Наприклад:

  • Set up a webhook to send notifications to the system you use.
  • Pass information to the third-party services with the specific request requirements (for example, HTTP method, сontent type).
  • Створити користувацькі інтеграції з Crowdin.


You can configure webhooks for the following types of events:

Webhook Payload Examples

Read more about Webhook Events (File-based) and Webhook Events (String-based) on Crowdin Developer Portal.

Додавання вебхуків

To configure webhooks in Crowdin, open your project and go to Tools > Webhooks. Натисніть Додати вебхук, щоб почати налаштовувати новий вебхук.

You will need to provide the following information to register a webhook:

  • Назва вебхука (наприклад, «Перекладено проєкт програми»).
  • Події для публікації через URL. Ви можете вибрати або одну подію, або певний набір подій.
  • URL, на яку повинно бути відправлений зворотний виклик.
  • The request method that indicates the desired action to be performed for a given resource (use either GET or POST).
  • The content type for the POST request method (multipart/form-data, application/json, or application/x-www-form-urlencoded).
  • For the application/json content type, you can select Batch webhooks to merge multiple events into a single request.

Optionally, you can add special headers to your webhook. They can be used for additional security, as an authorization method, and more. For example, if you add headers, your webhook endpoint can check them to ensure that information is coming from Crowdin.

When adding a webhook, click Test webhook to see how your application will react to that call.

Add Webhook

Depending on your approach to webhook management, you might need to add dedicated Crowdin IP addresses to your firewall to allow Crowdin to open the pre-configured webhook URLs.

Read more about IP Addresses.

Редагування або видалення вебхуків

Within a specific project, you can access and manage configured webhooks by editing or deleting them directly from the displayed list.

Manage Webhooks

Історія викликів

In the Calls History section, you can view the list of calls of all webhooks that were configured in the project. Use the filter to view all or only unsuccessful webhook notifications.

calls history

Failing Webhooks

Webhooks that fail 100 or more times in the last 24 hours with response codes in the 4xx or 5xx ranges are automatically disabled.

Disabled Webhooks

Disabled webhooks are listed in the Webhooks section with a cleared check mark, indicating that they are currently inactive due to persistent failures. To discover more about failed webhooks, navigate to the Calls History > Unsuccessful section. Here you can explore detailed information about the issues encountered by each failed webhook.

Manual Re-enabling

Once you have identified and resolved the cause of the webhook failures, you can manually re-enable the webhooks to restore their functionality. In the Webhooks section, locate the disabled webhook and select it for re-enabling.

Потрібна допомога

Need help working with Webhooks or have any questions? Зв’язатись з командою підтримки.

Ця стаття була корисною?