Create a webhook

Registers an endpoint. The response includes the signing secret — it is shown only once, so store it.

POSThttps://api.clicklookup.com/v1/webhooks

Requires an API key

Request body2

eventsarray of enumsrequired
Events that trigger a delivery.
urlstring · urlrequired
Absolute http(s) URL

Response · 2012

secretstringrequired
webhookobjectrequired
Show 7 child attributesHide child attributes
- createdAtstring · date-timerequired
  ISO-8601 timestamp with offset
- enabledbooleanrequired
  Whether the item is active.
- eventsarray of enumsrequired
  Events that trigger a delivery.
- idstring · uuidrequired
  UUID primary key
- updatedAtstring · date-timerequired
  ISO-8601 timestamp with offset
- urlstring · urlrequired
  Absolute http(s) URL
- workspaceIdstring · uuidrequired
  UUID primary key

Request

curl -X POST "https://api.clicklookup.com/v1/webhooks" \
  -H "Authorization: Bearer $CLICKLOOKUP_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://example.com/hooks/clicklookup",
    "events": [
      "conversion.received",
      "click.cap_reached"
    ]
  }'

Response

{
  "secret": "whsec_8c1f4e2a9b7d",
  "webhook": {
    "createdAt": "2026-09-22T10:15:00Z",
    "enabled": false,
    "events": [
      "click.cap_reached"
    ],
    "id": "c2e84b19-6f3a-4d7c-8a5e-1b9f2d6e4a73",
    "updatedAt": "2026-09-22T10:15:00Z",
    "url": "https://example.com/offer",
    "workspaceId": "c2e84b19-6f3a-4d7c-8a5e-1b9f2d6e4a73"
  }
}