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

# List Webhooks

> List all webhooks registered in your workspace. REST endpoint in the Tuco AI iMessage API — bearer-token auth, JSON request/response, full schema and code.

Returns all webhooks for your workspace, sorted by creation date (newest first). Secrets are **never** returned.

## Authentication

Pass your workspace API key as a Bearer token.

```bash theme={null}
Authorization: Bearer tuco_sk_xxxxxxxxxxxxx
```

***

## Response

<ResponseField name="webhooks" type="array">
  Array of webhook objects. Each includes:

  <Expandable title="Webhook fields">
    <ResponseField name="id" type="string">Webhook ID</ResponseField>
    <ResponseField name="url" type="string">Endpoint URL</ResponseField>
    <ResponseField name="events" type="string[]">Subscribed event types</ResponseField>
    <ResponseField name="name" type="string">User-friendly name</ResponseField>
    <ResponseField name="description" type="string | null">Optional description</ResponseField>
    <ResponseField name="isActive" type="boolean">Whether the webhook is currently active</ResponseField>
    <ResponseField name="lastTriggeredAt" type="string | null">Last time any event was sent (ISO UTC)</ResponseField>
    <ResponseField name="lastSuccessAt" type="string | null">Last successful delivery (ISO UTC)</ResponseField>
    <ResponseField name="lastFailureAt" type="string | null">Last failed delivery (ISO UTC)</ResponseField>
    <ResponseField name="failureCount" type="number">Consecutive failure count</ResponseField>
    <ResponseField name="createdAt" type="string">Creation timestamp (ISO UTC)</ResponseField>
    <ResponseField name="updatedAt" type="string">Last update timestamp (ISO UTC)</ResponseField>
  </Expandable>
</ResponseField>

***

## Example

```bash theme={null}
curl "https://app.tuco.ai/api/webhooks" \
  -H "Authorization: Bearer tuco_sk_xxxxxxxxxxxxx"
```

```json 200 Response theme={null}
{
  "webhooks": [
    {
      "id": "680a1b2c3d4e5f6789012345",
      "url": "https://example.com/webhooks/tuco",
      "events": ["message.sent", "message.failed", "message.reply"],
      "name": "Production webhook",
      "description": "Sends events to our CRM",
      "isActive": true,
      "lastTriggeredAt": "2026-04-12T10:30:00.000Z",
      "lastSuccessAt": "2026-04-12T10:30:00.000Z",
      "lastFailureAt": null,
      "failureCount": 0,
      "createdAt": "2026-03-01T00:00:00.000Z",
      "updatedAt": "2026-04-12T10:30:00.000Z"
    }
  ]
}
```