Create a webhook subscription

Registers an endpoint. Set scope to account to receive events from every profile through one endpoint. The signing secret is returned once.

Required permission: `webhooks:write`

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

Base URL

https://api.cutedyno.com

Permission

webhooks:write

Idempotency

Send an Idempotency-Key header so a retry cannot apply twice. How it works

MCP tool

create_webhook

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

{
  "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"
  },
  "secret": "whsec_2f8a...",
  "retrySchedule": [
    0
  ]
}