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

# Get Webhook

> Get details for a single webhook. REST endpoint in the Tuco AI iMessage API — bearer-token auth, JSON request/response, full schema and code examples.

Returns details for a single webhook. The secret is **never** returned.

## Authentication

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

***

## Path parameters

<ParamField path="id" type="string" required>
  Webhook ID (returned when you created the webhook).
</ParamField>

***

## Response

<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">Webhook name</ResponseField>
<ResponseField name="description" type="string | null">Optional description</ResponseField>
<ResponseField name="isActive" type="boolean">Whether the webhook is active</ResponseField>
<ResponseField name="lastTriggeredAt" type="string | null">Last event 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</ResponseField>
<ResponseField name="updatedAt" type="string">Last update timestamp</ResponseField>

***

## Example

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

```json 200 Response theme={null}
{
  "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"
}
```

<Tip>
  Use `lastSuccessAt`, `lastFailureAt`, and `failureCount` to monitor your endpoint's health.
  If `failureCount` is climbing, your endpoint might be down.
</Tip>