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

# Webhooks

> List and update your webhook subscriptions.

Manage webhook subscriptions. They are scoped to your user rather than shared with the workspace. See the [Webhooks guide](/docs/webhooks) to create an endpoint, retrieve its signing secret, or delete it.

Your endpoint receives:

* `video.created` for videos you create through MCP
* activity on videos you own, like views and milestones — even when a teammate or an anonymous viewer triggers it
* playlist events, currently only for actions performed in the Tella web app

## list\_webhooks

List your webhook subscriptions, with cursor pagination.

<ParamField path="cursor" type="string">
  Pagination cursor from previous response
</ParamField>

<ParamField path="limit" type="integer">
  Items per page (1-100, default: 20)
</ParamField>

## update\_webhook

Update a webhook subscription's URL, event filters, or delivery status. Provide at least one of `url`, `filterTypes`, or `disabled`.

<ParamField path="id" type="string" required>
  Webhook endpoint ID
</ParamField>

<ParamField path="url" type="string">
  New delivery URL
</ParamField>

<ParamField path="filterTypes" type="string[] | null">
  New event types to deliver, as a non-empty array (it cannot be `[]`). Pass `null` to clear the filter and deliver every event type. To stop delivery entirely, use `disabled: true` instead
</ParamField>

<ParamField path="disabled" type="boolean">
  Pause (`true`) or resume (`false`) webhook delivery
</ParamField>


## Related topics

- [Webhooks](/docs/webhooks.md)
- [Delete a webhook endpoint](/docs/api-reference/webhooks/delete-a-webhook-endpoint.md)
- [Update a webhook endpoint](/docs/api-reference/webhooks/update-a-webhook-endpoint.md)
- [Create a webhook endpoint](/docs/api-reference/webhooks/create-a-webhook-endpoint.md)
- [List webhook endpoints](/docs/api-reference/webhooks/list-webhook-endpoints.md)