Skip to main content
GET
/
api
/
webhooks
List Webhooks
curl --request GET \
  --url https://app.tuco.ai/api/webhooks \
  --header 'Authorization: Bearer <token>'
{
  "webhooks": [
    {
      "id": "<string>",
      "url": "<string>",
      "events": [
        "<string>"
      ],
      "name": "<string>",
      "description": {},
      "isActive": true,
      "lastTriggeredAt": {},
      "lastSuccessAt": {},
      "lastFailureAt": {},
      "failureCount": 123,
      "createdAt": "<string>",
      "updatedAt": "<string>"
    }
  ]
}

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.

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.
Authorization: Bearer tuco_sk_xxxxxxxxxxxxx

Response

webhooks
array
Array of webhook objects. Each includes:

Example

curl "https://app.tuco.ai/api/webhooks" \
  -H "Authorization: Bearer tuco_sk_xxxxxxxxxxxxx"
200 Response
{
  "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"
    }
  ]
}