Trawl API reference

Trawl API · Webhooks

get/v1/workspaces/{workspace_id}/webhooksAuth

List webhooks for the workspace (paginated, newest first, secrets masked)

Deprecated: use `/v1/workspaces/{workspace_id}/webhooks/endpoints` (event filter, event descriptions, Send test that reports the result, event log, replay, rotation with a grace period). Responses carry `Deprecation: true` and `Sunset: Fri, 15 Jan 2027 00:00:00 GMT`.

Path parameters

workspace_id*string · uuid

Id of the workspace.

Query parameters

cursorstring

Opaque cursor from the previous response's `pagination.next_cursor`.

limitinteger

Page size. Defaults to 20, capped at 100.

Response · 200 Page of webhooks with a pagination cursor.

data*array
pagination*object
next_cursor*string
has_more*boolean

Example

Request

GET https://api.trawl.productcraft.co/v1/workspaces/{workspace_id}/webhooks
Authorization: Bearer YOUR_TOKEN

Response

{
  "data": [
    {
      "id": "00000000-0000-0000-0000-000000000000",
      "workspace_id": "00000000-0000-0000-0000-000000000000",
      "url": "string",
      "active": false,
      "failure_count": 0,
      "last_status_code": 0,
      "last_attempt_at": "2026-01-01T00:00:00.000Z",
      "auto_disabled_at": "2026-01-01T00:00:00.000Z",
      "first_failure_at": "2026-01-01T00:00:00.000Z",
      "created_at": "2026-01-01T00:00:00.000Z",
      "secret_set": false
    }
  ],
  "pagination": {
    "next_cursor": "string",
    "has_more": false
  }
}