> ## Documentation Index
> Fetch the complete documentation index at: https://www.tella.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Set up webhooks

> Send real-time notifications to your own systems when videos, exports, transcripts, playlists, and views happen in Tella.

Webhooks push a message to a URL you control the moment something happens in Tella — a video finishes recording, an export is ready, a viewer watches. Use them when you want your own system to react to Tella without polling the API.

To set them up, click your avatar, go to **Settings**, then **Webhooks** under **Other**.

<Note>
  Webhooks are available to workspace owners and members. Viewers do not see this page. If you see "Webhooks are not available for your account," ask a workspace owner to set them up.
</Note>

## Add an endpoint

1. Go to **Settings → Webhooks**.
2. Add a new endpoint.
3. Paste the URL that should receive the events. It must be a publicly reachable HTTPS URL — a service running only on your laptop will not receive anything unless you expose it with a tunnel.
4. Choose which events to subscribe to. Subscribe only to what you actually handle; every extra event is a request your endpoint has to answer.
5. Save the endpoint.

## Events you can subscribe to

| Event                  | Fires when                                  |
| ---------------------- | ------------------------------------------- |
| `video.created`        | A new video is created in your workspace    |
| `video.viewed`         | Someone watches a video                     |
| `video.milestone`      | A video passes a view milestone             |
| `export.ready`         | An export finishes and is ready to download |
| `transcript.ready`     | A video's transcript finishes processing    |
| `playlist.created`     | A new playlist is created                   |
| `playlist.video_added` | A video is added to a playlist              |

For the exact payload each event sends, see the [webhooks reference](/docs/webhooks) in the developer documentation.

## Test and debug

The webhooks page is a full management portal, not just a list. From it you can:

* **Send a test event** to confirm your endpoint is reachable before you rely on it.

* **See delivery attempts** for every message, including the response your endpoint returned.

* **Replay a failed message** once you have fixed the problem on your side, instead of waiting for the event to happen again.

If deliveries are failing, check the attempt log first — it usually shows the exact status code and body your endpoint returned.

## Verify the messages you receive

Each message is signed, so you can confirm it genuinely came from Tella and was not forged by someone who guessed your URL. Verify the signature before acting on a payload. The signing secret and verification steps are in the [webhooks reference](/docs/webhooks).

## Related

* [Public API and webhooks](/docs/help/integrations/public-api-and-webhooks) — what you can build with the API.

* [Create and manage API keys](/docs/help/integrations/api-keys) — authenticating your own calls back to Tella.


## Related topics

- [Quickstart](/docs/quickstart.md)
- [Webhooks](/docs/webhooks.md)
- [Set up SSO](/docs/help/admin/set-up-sso.md)
- [How to fix audio sync for XLR microphones](/docs/help/troubleshooting/fix-audio-sync-for-xlr-microphones.md)
- [Add your custom domain](/docs/help/admin/add-your-custom-domain.md)