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"
    }
  ]
}