> ## 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

> Workspace owners and members add webhook endpoints in Settings → Webhooks to get real-time events for new videos, views, view milestones, exports, transcripts, and playlists.

Workspace owners and members set up webhooks in **Settings** → **Webhooks**, under **Other**. A webhook pushes a message to a URL you control the moment something happens in Tella: a video is created, an export is ready, a viewer watches. Use them when you want your own system to react to Tella without polling the API.

To open the page, click your **workspace name** in the top-left corner, go to **Settings**, then **Webhooks**.

<Note>
  Webhooks are available to workspace owners and members. Viewers do not see this page. If the page shows "Webhooks are not available for your account," the webhook portal couldn't load for your workspace; email [support@tella.com](mailto:support@tella.com).
</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.

## Which webhook events does Tella send?

| Event | Fires when |
| - | - |
| `video.created` | A new video is created in your workspace |
| `video.viewed` | Someone watches a video |
| `video.milestone` | A video passes 1, 5, 10, 25, 50, 100, or 500 views |
| `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 a webhook

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 webhook signatures

Each message is signed, so you can confirm it 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

- [Public API and webhooks](/docs/help/integrations/public-api-and-webhooks.md)
- [Quickstart](/docs/quickstart.md)
- [Webhooks](/docs/webhooks.md)
- [Set up SSO](/docs/help/admin/set-up-sso.md)
- [Set up two-factor authentication](/docs/help/account/two-factor-authentication.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.