Skip to content

Delete a webhook endpoint

DELETE/v1/webhook_endpoints/{id}

Deliveries still waiting for this endpoint are abandoned. The delivery log is kept.

Send your API key as a bearer token in the Authorization header. Secret API key: Authorization: Bearer ctp_live_sk_…. A publishable key (ctp_…_pk_…) is accepted by these operations only, which serve reference data: getRate, listAssets, listNetworks (each marked x-publishable-key: true). Every other operation refuses it with 403 publishable_key_not_allowed, whatever Origin the request carries: that header binds browsers, not other clients, and nothing on this API relies on it.

Name Type Description
id required string At most 100 characters.
Terminal window
curl -X DELETE "https://api.ctpeway.com/v1/webhook_endpoints/{id}" \
-H "Authorization: Bearer $CTPEWAY_API_KEY"
Field Type Description
id string 24 hexadecimal characters.
deleted boolean Always true.
{
"id": "0123456789abcdef01234567",
"deleted": true
}

The values are placeholders generated from the schema. They show the shape, not real data.

A failed request answers with the error format described under Errors.

Besides the codes any endpoint can return, this endpoint can answer with these code values: