API reference · Webhooks

Update a subscription

PATCHhttps://goblins-call-api.onrender.com/v1/webhooks/:id

Changes where a subscription delivers, which events it receives, or pauses it.

Needs a workspace API key.

Path parameters

idstringRequired

The subscription’s ID, such as wh_3f9a1c2b7d4e5f60.

Body

urlstringOptional

Where events are delivered, as a POST with a JSON body. Must be a public address.

eventsstring[]Optionalat least 1

The event types to receive, or ["*"] for all of them.

descriptionstringOptionalup to 200 chars

A label for your own reference.

enabledbooleanOptionaldefault true

false keeps the subscription without delivering to it.

Errors

400

The body failed validation. details lists each field and what is wrong with it.

400URL_NOT_ALLOWED

The URL is not a public http(s) address.

404

No subscription in your workspace has that ID.

Every request can also answer 401, 429 and 500: see Errors.

Notes

The signing secret is fixed when the subscription is created. To change it, delete the subscription and create a new one.

curl -X PATCH "https://goblins-call-api.onrender.com/v1/webhooks/wh_3f9a1c2b7d4e5f60" \
  -H "Authorization: Bearer $CRACKLE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "events": [
    "call.started",
    "call.ended"
  ],
  "enabled": true
}'

Response · 200 OK

{
  "webhook": {
    "id": "wh_3f9a1c2b7d4e5f60",
    "userId": "usr_8c1d2e3f4a5b",
    "url": "https://your-app.com/webhooks/crackle",
    "events": ["call.ended"],
    "enabled": true,
    "secret": "whsec_9c4f…a630",
    "createdAt": "2026-10-11T08:31:10.000Z",
    "updatedAt": "2026-10-11T08:31:10.000Z"
  }
}