Remove an API webhook

DEL/webhooks/{webhookId}

Removes a webhook this API subscribed. Webhooks added in Settings stay.

Try itSend a real request with your API key

Path

webhookIdstringRequired
The webhook.

Headers

Idempotency-Keystring
Any unique value up to 255 characters, like a UUID. The request runs once; repeats within 24 hours get the first answer, with Idempotent-Replayed: true. Up to 255 characters.

Answer

200 OK Removed.

dataobjectRequired
Inside it
- idstringRequired
- deletedbooleanRequired

Errors

401 Unauthorizedunauthorized
404 Not foundnot_found not_in_campaign
429 Too many requestsrate_limited
500 Server errorserver_error

Every error has the same shape. See Errors.

DELETE /webhooks/{webhookId}

curl -X DELETE "https://app.salesteam.dev/api/v1/webhooks/WEBHOOK_ID" \
  -H "Authorization: Bearer $SALESTEAM_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)"

const response = await fetch("https://app.salesteam.dev/api/v1/webhooks/WEBHOOK_ID", {
  method: "DELETE",
  headers: {
    Authorization: `Bearer ${process.env.SALESTEAM_API_KEY}`,
    "Idempotency-Key": crypto.randomUUID(),
  },
});
console.log(response.status, await response.json());

import os, uuid
import requests

response = requests.delete(
    "https://app.salesteam.dev/api/v1/webhooks/WEBHOOK_ID",
    headers={"Authorization": f"Bearer {os.environ['SALESTEAM_API_KEY']}", "Idempotency-Key": str(uuid.uuid4())},
)
print(response.status_code, response.json())

200 answer

{
  "data": {
    "id": "id_7Qm2xT9a",
    "deleted": true
  }
}