Create webhook

Query parameters

This endpoint has no query parameters.

Request body

Send JSON with Content-Type: application/json.

• urlstringrequired

  HTTPS callback URL (localhost allowed in development)

  Example: https://example.com/hooks/clipsonar

• eventsstring[]required

  One or more of: creator.created, creator.ready, creator.failed, analysis.completed, credits.depleted, insights.ready

{
  "url": "https://example.com/hooks/clipsonar",
  "events": [
    "creator.ready",
    "creator.failed",
    "analysis.completed"
  ]
}

Response

201 Created endpoint including signing `secret`. List responses omit `secret`.

• idstringrequired

  Endpoint id

• urlstringrequired

  Callback URL

• eventsstring[]required

  Subscribed events

• workspace_idstring | nullrequired

  Workspace scope for this endpoint

• disabled_atstring | nullrequired

  Set when disabled

• created_atstringrequired

  ISO create time

• secretstringrequired

  HMAC signing secret (create response only for this API)

{
  "id": "cb2c7ed0-5ef6-4b2a-899e-4e837d5abf20",
  "url": "https://example.com/hooks/clipsonar",
  "events": [
    "creator.ready",
    "creator.failed",
    "analysis.completed"
  ],
  "workspace_id": "c916a1f3-68bc-466e-91d9-f7e086df2011",
  "disabled_at": null,
  "created_at": "2026-08-04T15:44:48.318Z",
  "secret": "whsec_…"
}