Webhooks

Webhooks allow you to receive real-time notifications when specific events occur. You can subscribe, retrieve, update, and delete webhooks using the API.

Get All Webhooks

Retrieve a list of all registered webhooks.

get

Authorizations

x-api-keystringRequired

Query parameters

limitstringOptional

pagestringOptional

Header parameters

x-api-keystringRequired

Responses

200

200 response

application/json

idstringOptional

Unique identifier for the endpoint

namestringRequired

Human-readable name for the endpoint

activebooleanRequired

Indicates whether the endpoint is active or not

serverUrlstring · uriRequired

URL of the server where webhooks are sent

createdAtstring · date-timeOptional

Timestamp of endpoint creation

updatedAtstring · date-timeOptional

Timestamp of endpoint update

get/v1/webhooks

GET /v1/webhooks HTTP/1.1
x-api-key: text
Accept: */*

200

200 response

[
  {
    "id": "text",
    "name": "text",
    "active": true,
    "serverUrl": "https://example.com",
    "webhookHeaders": [
      {
        "key": "text",
        "value": "text"
      }
    ],
    "events": [
      "incoming_whatsapp_message"
    ],
    "createdAt": "2026-01-01T00:00:00.000Z",
    "updatedAt": "2026-01-01T00:00:00.000Z"
  }
]

Create Webhook

Register a new webhook subscription.

post

Authorizations

x-api-keystringRequired

Header parameters

x-api-keystringRequired

Body

idstringOptional

Unique identifier for the endpoint

namestringRequired

Human-readable name for the endpoint

activebooleanRequired

Indicates whether the endpoint is active or not

serverUrlstring · uriRequired

URL of the server where webhooks are sent

createdAtstring · date-timeOptional

Timestamp of endpoint creation

updatedAtstring · date-timeOptional

Timestamp of endpoint update

Responses

200

200 response

application/json

idstringOptional

Unique identifier for the endpoint

namestringRequired

Human-readable name for the endpoint

activebooleanRequired

Indicates whether the endpoint is active or not

serverUrlstring · uriRequired

URL of the server where webhooks are sent

createdAtstring · date-timeOptional

Timestamp of endpoint creation

updatedAtstring · date-timeOptional

Timestamp of endpoint update

post/v1/webhooks

POST /v1/webhooks HTTP/1.1
x-api-key: text
Content-Type: application/json
Accept: */*
Content-Length: 241

{
  "id": "text",
  "name": "text",
  "active": true,
  "serverUrl": "https://example.com",
  "webhookHeaders": [
    {
      "key": "text",
      "value": "text"
    }
  ],
  "events": [
    "incoming_whatsapp_message"
  ],
  "createdAt": "2026-01-01T00:00:00.000Z",
  "updatedAt": "2026-01-01T00:00:00.000Z"
}

200

200 response

{
  "id": "text",
  "name": "text",
  "active": true,
  "serverUrl": "https://example.com",
  "webhookHeaders": [
    {
      "key": "text",
      "value": "text"
    }
  ],
  "events": [
    "incoming_whatsapp_message"
  ],
  "createdAt": "2026-01-01T00:00:00.000Z",
  "updatedAt": "2026-01-01T00:00:00.000Z"
}

Get Webhook By Id

Retrieve details of a specific webhook subscription.

get

Authorizations

x-api-keystringRequired

Path parameters

webhookIdstringRequired

Header parameters

x-api-keystringRequired

Responses

200

200 response

application/json

idstringOptional

Unique identifier for the endpoint

namestringRequired

Human-readable name for the endpoint

activebooleanRequired

Indicates whether the endpoint is active or not

serverUrlstring · uriRequired

URL of the server where webhooks are sent

createdAtstring · date-timeOptional

Timestamp of endpoint creation

updatedAtstring · date-timeOptional

Timestamp of endpoint update

get/v1/webhooks/{webhookId}

GET /v1/webhooks/{webhookId} HTTP/1.1
x-api-key: text
Accept: */*

200

200 response

{
  "id": "text",
  "name": "text",
  "active": true,
  "serverUrl": "https://example.com",
  "webhookHeaders": [
    {
      "key": "text",
      "value": "text"
    }
  ],
  "events": [
    "incoming_whatsapp_message"
  ],
  "createdAt": "2026-01-01T00:00:00.000Z",
  "updatedAt": "2026-01-01T00:00:00.000Z"
}

Update Webhook

Update an existing webhook subscription.

put

Authorizations

x-api-keystringRequired

Path parameters

webhookIdstringRequired

Header parameters

x-api-keystringRequired

Body

idstringOptional

Unique identifier for the endpoint

namestringRequired

Human-readable name for the endpoint

activebooleanRequired

Indicates whether the endpoint is active or not

serverUrlstring · uriRequired

URL of the server where webhooks are sent

createdAtstring · date-timeOptional

Timestamp of endpoint creation

updatedAtstring · date-timeOptional

Timestamp of endpoint update

Responses

200

200 response

application/json

idstringOptional

Unique identifier for the endpoint

namestringRequired

Human-readable name for the endpoint

activebooleanRequired

Indicates whether the endpoint is active or not

serverUrlstring · uriRequired

URL of the server where webhooks are sent

createdAtstring · date-timeOptional

Timestamp of endpoint creation

updatedAtstring · date-timeOptional

Timestamp of endpoint update

put/v1/webhooks/{webhookId}

PUT /v1/webhooks/{webhookId} HTTP/1.1
x-api-key: text
Content-Type: application/json
Accept: */*
Content-Length: 241

{
  "id": "text",
  "name": "text",
  "active": true,
  "serverUrl": "https://example.com",
  "webhookHeaders": [
    {
      "key": "text",
      "value": "text"
    }
  ],
  "events": [
    "incoming_whatsapp_message"
  ],
  "createdAt": "2026-01-01T00:00:00.000Z",
  "updatedAt": "2026-01-01T00:00:00.000Z"
}

200

200 response

{
  "id": "text",
  "name": "text",
  "active": true,
  "serverUrl": "https://example.com",
  "webhookHeaders": [
    {
      "key": "text",
      "value": "text"
    }
  ],
  "events": [
    "incoming_whatsapp_message"
  ],
  "createdAt": "2026-01-01T00:00:00.000Z",
  "updatedAt": "2026-01-01T00:00:00.000Z"
}

Delete Webhook

Remove a webhook subscription.

delete

Authorizations

x-api-keystringRequired

Path parameters

webhookIdstringRequired

Header parameters

x-api-keystringRequired

Responses

200

200 response

application/json

successbooleanOptional

delete/v1/webhooks/{webhookId}

DELETE /v1/webhooks/{webhookId} HTTP/1.1
x-api-key: text
Accept: */*

200

200 response

{
  "success": true
}