Delete a webhook
Delete an outbound webhook by id (from list_workspace_webhooks). Deliveries stop immediately. Destructive, needs confirm: true. Requires workspace-admin.
Authorization
bearerAuth A personal access token from Settings > API tokens.
In: header
Path Parameters
Workspace slug (GET /me lists yours).
Query Parameters
Must be true to perform this action. It deletes something, publishes, or changes what live callers get straight away, so confirm with the user first.
Response Body
application/json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
curl -X DELETE "https://example.com/workspaces/string/webhooks/string"{
"deleted": "string",
"property1": null,
"property2": null
}{
"type": "http://example.com",
"title": "string",
"status": 0,
"detail": "string",
"code": "string",
"errors": [
{
"path": "string",
"message": "string"
}
],
"estimate": {},
"retryAfterSeconds": 0
}{
"type": "http://example.com",
"title": "string",
"status": 0,
"detail": "string",
"code": "string",
"errors": [
{
"path": "string",
"message": "string"
}
],
"estimate": {},
"retryAfterSeconds": 0
}{
"type": "http://example.com",
"title": "string",
"status": 0,
"detail": "string",
"code": "string",
"errors": [
{
"path": "string",
"message": "string"
}
],
"estimate": {},
"retryAfterSeconds": 0
}{
"type": "http://example.com",
"title": "string",
"status": 0,
"detail": "string",
"code": "string",
"errors": [
{
"path": "string",
"message": "string"
}
],
"estimate": {},
"retryAfterSeconds": 0
}{
"type": "http://example.com",
"title": "string",
"status": 0,
"detail": "string",
"code": "string",
"errors": [
{
"path": "string",
"message": "string"
}
],
"estimate": {},
"retryAfterSeconds": 0
}{
"type": "http://example.com",
"title": "string",
"status": 0,
"detail": "string",
"code": "string",
"errors": [
{
"path": "string",
"message": "string"
}
],
"estimate": {},
"retryAfterSeconds": 0
}{
"type": "http://example.com",
"title": "string",
"status": 0,
"detail": "string",
"code": "string",
"errors": [
{
"path": "string",
"message": "string"
}
],
"estimate": {},
"retryAfterSeconds": 0
}Create a webhook POST
Create an outbound webhook that POSTs workspace events to an https URL. Event keys: conversation.started, conversation.ended, call_log.completed, lead.received, lead.updated, campaign.launched, campaign.scheduled, campaign.paused, campaign.resumed, campaign.completed, campaign.cancelled, campaign.recipient.finished, alert.fired, metric.optimised. Omit events to subscribe to all of them. Returns the signing secret once (deliveries are signed in X-VAI-Signature as t=<unix seconds>,v1=<hex HMAC-SHA256 of "<t>.<raw body>">); it also stays visible in Settings → Webhooks. Requires workspace-admin.
List a webhook's deliveries and their attempts GET
The delivery log of one webhook, newest first: each event sent to it (eventId, event, status pending, delivered or failed, attempts, lastHttpStatus, lastError, deliveredAt, redeliverable) with every HTTP attempt in attemptLog (attempt, endpointUrl, httpStatus, latencyMs, responseExcerpt, error, redelivery, at). A failed attempt is retried with backoff (30 s, doubling to 15 minutes) up to 8 times. Pass next_cursor back as cursor for older deliveries. Requires workspace-admin.