# General Translation Platform: Webhooks
URL: https://generaltranslation.com/en-GB/docs/platform/webhooks.mdx
---
title: Webhooks
description: Send translation events from an organisation to your application
---

Webhooks send HTTP POST requests to your application when events occur in an organisation. Use them to trigger downstream workflows after translation activity.

## Event types

Webhook endpoints can subscribe to these public events:

| Event                       | When it fires                                                  |
| --------------------------- | -------------------------------------------------------------- |
| `translated_file.completed` | A translated file is completed and ready to download           |
| `translated_file.edited`    | A translated file is manually edited in the translation editor |
| `translation_job.completed` | A translation job completes                                    |

## Add an endpoint

1. Open **Organisation -> Webhooks**
2. Click **Add endpoint**
3. Enter the endpoint URL
4. Optionally add a description
5. Select the event types to deliver
6. Click **Create endpoint**

The endpoint URL must be an HTTPS endpoint that can receive POST requests.

## Manage endpoints

Open an endpoint to update its URL, description, event subscriptions or status. You can also reveal the signing secret when you need to configure signature verification in your application.

## Review events

Open **Organisation -> Webhooks -> Events** to inspect recent events and their deliveries. Use this page to confirm whether events were delivered and to retry failed deliveries when available.

## Next steps

* [Editing translations](/docs/platform/translations)
* [API keys](/docs/platform/api-keys)