---
updatedAt: 2026-09-10T15:50:00.000Z
---

Fetch the complete documentation index at: https://docs.synthesia.io/llms.txt. Use this file to discover all available pages before exploring further. Append .md to any documentation page URL to get its markdown version.

# Webhooks

Set up webhooks to get notified when specific events occur throughout the Synthesia system.

When an event occurs, we send an HTTP POST request to any active webhooks that are subscribed to the applicable type of event. We expect a non-error response code (1xx, 2xx or 3xx) within six seconds in order to consider event delivery a success. In the case that event delivery fails, we will retry twice over a ten-minute window.

In order that you might verify the events you receive were sent by Synthesia, we sign each event. To learn more about verifying this signature, see [this guide](https://docs.synthesia.io/reference/verifying-synthesia-signatures).

<Table align={["left","left","left"]}>
  <thead>
    <tr>
      <th>
        Webhook Object Keys
      </th>

      <th>
        Type
      </th>

      <th>
        Description
      </th>
    </tr>
  </thead>

  <tbody>
    <tr>
      <td>
        id
      </td>

      <td>
        String
      </td>

      <td>
        Unique identifier for the webhook.
      </td>
    </tr>

    <tr>
      <td>
        url
      </td>

      <td>
        String
      </td>

      <td>
        URL to which we make the HTTP POST request.
      </td>
    </tr>

    <tr>
      <td>
        status
      </td>

      <td>
        String
      </td>

      <td>
        The status of the webhook, either `active` or `deleted`.
      </td>
    </tr>

    <tr>
      <td>
        secret
      </td>

      <td>
        String
      </td>

      <td>
        The webhook secret which is required to [verify the signature](https://docs.synthesia.io/reference/verifying-synthesia-signatures) we send you.

        Note that this secret is only available at time of webhook creation.
      </td>
    </tr>

    <tr>
      <td>
        createdAt
      </td>

      <td>
        Integer
      </td>

      <td>
        UNIX timestamp representing the time the webhook was created.
      </td>
    </tr>

    <tr>
      <td>
        lastUpdatedAt
      </td>

      <td>
        Integer
      </td>

      <td>
        UNIX timestamp representing the time the webhook was last updated.
      </td>
    </tr>
  </tbody>
</Table>

```json Webhook object
{
  "id":"1234-...",
  "url":"https://webhook.site/1234-...",
  "status":"active",
  "secret":"1234-...",
  "createdAt":1623656907,
  "lastUpdatedAt":1623656907
}
```

<br />

# Sub pages

* [Delete a webhook](https://docs.synthesia.io/reference/delete-a-webhook.md)
* [Retrieve a webhook](https://docs.synthesia.io/reference/retrieve-a-webhook.md)
* [List webhooks](https://docs.synthesia.io/reference/list-webhooks.md)
* [Create a Webhook](https://docs.synthesia.io/reference/create-a-webhook.md)

# Sibling pages

* [Video API Introduction](https://docs.synthesia.io/reference/video-api-introduction.md)
* [Video API Quickstart](https://docs.synthesia.io/reference/synthesia-api-quickstart.md)
* [Templates](https://docs.synthesia.io/reference/templates.md)
* [Videos](https://docs.synthesia.io/reference/videos.md)
* [Dubbing](https://docs.synthesia.io/reference/dubbing.md)
* [Translations](https://docs.synthesia.io/reference/translations.md)
* [Audit Logs](https://docs.synthesia.io/reference/audit-logs.md)
* [Assets](https://docs.synthesia.io/reference/assets-1.md)