Skip to main content
List the active webhooks for the authenticated workspace, with the most recently created first. The signing secret is never returned here — it is shown only once, when you run clay webhooks create. See the webhooks overview for the delivery payload shape and signature verification. 
clay webhooks list [--limit <n>] [--cursor <token>]
Results are paginated. --limit sets the page size, and the response includes a top-level cursor when more webhooks are available; pass it back with --cursor to fetch the next page.

​
Flags

FlagDescription
--limit <n>Maximum webhooks to return per page (1–200). Defaults to 50.
--cursor <token>Resume from a previous response’s cursor to fetch the next page.

​
Output

{
  "data": [
    {
      "id": "wh_abc123",
      "url": "https://example.com/hooks/clay",
      "createdAt": "2026-06-16T17:50:00.000Z"
    }
  ],
  "cursor": "next_page_token"
}
FieldTypeDescription
data[].idstringWebhook id.
data[].urlstringThe endpoint that receives deliveries.
data[].createdAtstringCreation timestamp.
cursorstringPresent when more webhooks are available. Pass it back via --cursor. Omitted on the last page.

​
Errors

CodeExitNotes
validation_error2--limit is not a positive integer.
auth_forbidden3The API key lacks permission to manage webhooks.
not_found6Webhooks are not enabled.

​
Examples

clay webhooks list
clay webhooks list --limit 100 | jq -r '.data[].url'
clay webhooks list --limit 100 --cursor "$CURSOR"