OverviewAPI ReferenceResources
Webhooks

Delete webhook

Deletes a webhook. Send its id in the JSON body. Works on any paid plan, so you can remove webhooks after a downgrade.

DELETE
/api/v1/webhooks

Authorization

AuthorizationRequiredBearer <token>

A Convo API key: convo_ followed by 32 hex characters. Create it in the Convo desktop app under Settings → Convo API.

In: header

Request Body

application/jsonRequired
idRequiredstring

Webhook ID to delete

curl -X DELETE "https://www.itsconvo.com/api/v1/webhooks" \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{
    "id": "string"
  }'

Webhook deleted

Was this page helpful?

Register webhook

Registers a URL for the events you choose. The URL must use HTTPS and can't point to localhost or a private network. Professional plans can have 3 webhooks and Enterprise 999. The `secret` appears only in this response.

Test a webhook

Sends a signed `webhook.test` event to one of your webhooks and returns your server's status code. `delivered` is true whenever your server answered, whatever the status, so check `statusCode`. If your server doesn't answer within 10 seconds, the response is 200 with `delivered: false`.