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

# Webhooks

> Manage webhook endpoints

Configure webhooks to receive real-time event notifications.

## List Webhooks

<RequestExample>
  ```bash theme={null}
  curl -X GET https://cp.gosentrix.io/api/v1/tenants/{tenant_id}/webhooks \
    -H "Authorization: Bearer YOUR_ACCESS_TOKEN"
  ```
</RequestExample>

## Create Webhook

<RequestExample>
  ```bash theme={null}
  curl -X POST https://cp.gosentrix.io/api/v1/tenants/{tenant_id}/webhooks \
    -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
    -H "Content-Type: application/json" \
    -d '{
      "url": "https://example.com/webhook",
      "events": ["user.created", "user.updated"],
      "secret": "webhook-secret-key"
    }'
  ```
</RequestExample>

## Update Webhook

<RequestExample>
  ```bash theme={null}
  curl -X PATCH https://cp.gosentrix.io/api/v1/tenants/{tenant_id}/webhooks/{webhook_id} \
    -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
    -H "Content-Type: application/json" \
    -d '{
      "enabled": true
    }'
  ```
</RequestExample>

## Webhook Events

See [Webhook Events Reference](/reference/webhook-events) for a complete list of available events.

## Notes

* Webhooks use HMAC signature verification
* Failed deliveries are retried (see [Webhook Retries](/webhooks/retries))
* See [Webhooks Guide](/guides/webhooks) for setup details