Delete Webhook

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…

Deletes a webhook. Vendy stops sending it events.

📘

Event deliveries

Vendy sends each event as a JSON POST with an x-signature header. See the Webhooks overview for the event list and how to check signatures.

Request:

FieldInTypeRequiredDescription
idBodyStringYesThe webhook's id
businessIdQueryIntegerNoIgnored when you use API keys. See Authentication

Example request

curl --location 'https://api.myvendy.com/webhooks/delete-webhook' \
--header 'Content-Type: application/json' \
--header "AccessKey: $VENDY_ACCESS_KEY" \
--header "SecretKey: $VENDY_SECRET_KEY" \
--data '{
    "id": "39a1e4bf-fbc3-4b78-9555-c50f8cfa17bw"
}'

Response:

FieldTypeDescription
statusBooleanStates if request was successfully executed or not
codeIntegerInternal code, success if 200
msgStringThe webhook service's message, usually success
dataJSONEmpty

Example response

{
    "status": true,
    "code": 200,
    "msg": "success",
    "error": "success",
    "data": {}
}

Possible errors

Error codeDescription
218The webhook service rejected the request. msg says why, for example an unknown id
342Your keys lack permission to manage webhooks
Query Params
int32

Required when you call with a dashboard session token. With AccessKey/SecretKey it is ignored: the business comes from the key.

Body Params
string
required
Responses

Language
Credentials
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json