Update a webhook subscription

Changes the URL or event list, or pauses delivery with isActive: false. A paused subscription keeps its secret and its delivery history.

Required permission: `webhooks:write`

Accepts `profileId` to target a specific profile. Omit it to use the key’s home profile.

PATCH/v1/webhooks/{id}webhooks:write

Request

Authorization

Send your API key as a Bearer token in the Authorization header.

Path parameters

idstringrequired

Webhook subscription id.

Request body

profileIdstringoptional

Profile to act on. Defaults to the profile the API key was created in.

urlstringoptional

HTTPS endpoint that receives POSTs.

eventsenum[]optional

Replaces the current event list.

isActivebooleanoptional

Set false to stop delivering without deleting.

Response

Returns 200.

WebhookSubscriptionrequired

Errors

Failures use the standard error format.

Status	Code	When it happens
400	invalid_request	The request body or query string failed validation. The message names the offending field.
401	invalid_api_key	The key does not exist, was revoked, or is malformed. Keys start with cdyn_live_.
404	not_found	The resource does not exist inside the resolved profile.
429	rate_limit_exceeded	Too many requests for this key. Honour the Retry-After header before retrying.
500	internal_error	Something failed on our side. Retry with the same Idempotency-Key; report the requestId if it persists.

curl -X PATCH "https://api.cutedyno.com/v1/webhooks/WEBHOOK_ID" \
  -H "Authorization: Bearer $CUTEDYNO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "profileId": "profile_a1b2c3d4",
  "url": "https://cdn.example.com/media/launch.jpg",
  "events": [
    "account.connected"
  ],
  "isActive": false
}'

200Example response

{
  "subscription": {
    "id": "a1b2c3d4-0000-4000-8000-000000000000",
    "url": "https://cdn.example.com/media/launch.jpg",
    "events": [
      "string"
    ],
    "scope": "profile",
    "isActive": false,
    "createdAt": "string",
    "updatedAt": "string"
  }
}

Base URL: https://api.cutedyno.com