Delete webhook

Deletes a webhook subscription. The webhook ID is passed in the request body (not in the URL path).

DELETE /v1/webhooks

Delete webhook

cURL

curl --request DELETE \
  --url https://api.messages.dev/v1/webhooks \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "id": "wh_abc123"
}
'

200

{
  "id": "<string>",
  "deleted": true,
  "request_id": "<string>"
}

Authorizations

Authorization · string · header · required

Use an API key as a bearer token: Authorization: Bearer sk_live_...

Each key has a set of scopes that gate which endpoints it can call: messages:read, messages:write, chats:read, lines:read, reactions:read, reactions:write, typing:read, typing:write, receipts:read, receipts:write, webhooks:read, webhooks:write, outbox:read, files:read, files:write. Keys can also be restricted to a subset of lines.

Body

application/json

id · string · required

Webhook ID (prefixed with wh_)

Example:

"wh_abc123"

Response

200

application/json

Webhook deleted

id · string

ID of the deleted resource

deleted · boolean

request_id · string