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

/v1/webhooks

Authorizations

Query parameters

limitstring

pagestring

Header parameters

x-api-keystringrequired

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url '<YOUR HOST>/v1/webhooks' \
  --header 'x-api-key: text'

200

200

[
  {
    "id": "text",
    "name": "text",
    "active": true,
    "serverUrl": "https://example.com",
    "createdAt": "2025-02-28T07:00:54.571Z",
    "updatedAt": "2025-02-28T07:00:54.571Z",
    "events": [
      "incoming_whatsapp_message"
    ],
    "webhookHeaders": [
      {
        "key": "text",
        "value": "text"
      }
    ]
  }
]

200 response

Create Webhook

Register a new webhook subscription.

post

/v1/webhooks

Authorizations

Header parameters

x-api-keystringrequired

Body

idstring

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-time

Timestamp of endpoint creation

updatedAtstring · date-time

Timestamp of endpoint update

eventsstring · enum[]required

webhookHeadersobject[]

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request POST \
  --url '<YOUR HOST>/v1/webhooks' \
  --header 'x-api-key: text' \
  --header 'Content-Type: application/json' \
  --data '{
    "id": "text",
    "name": "text",
    "active": true,
    "serverUrl": "https://example.com",
    "createdAt": "2025-02-28T07:00:54.571Z",
    "updatedAt": "2025-02-28T07:00:54.571Z",
    "events": [
      "incoming_whatsapp_message"
    ],
    "webhookHeaders": [
      {
        "key": "text",
        "value": "text"
      }
    ]
  }'

200

200

{
  "id": "text",
  "name": "text",
  "active": true,
  "serverUrl": "https://example.com",
  "createdAt": "2025-02-28T07:00:54.571Z",
  "updatedAt": "2025-02-28T07:00:54.571Z",
  "events": [
    "incoming_whatsapp_message"
  ],
  "webhookHeaders": [
    {
      "key": "text",
      "value": "text"
    }
  ]
}

200 response

Get Webhook By Id

Retrieve details of a specific webhook subscription.

get

/v1/webhooks/{webhookId}

Authorizations

Path parameters

webhookIdstringrequired

Header parameters

x-api-keystringrequired

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url '<YOUR HOST>/v1/webhooks/{webhookId}' \
  --header 'x-api-key: text'

200

200

{
  "id": "text",
  "name": "text",
  "active": true,
  "serverUrl": "https://example.com",
  "createdAt": "2025-02-28T07:00:54.571Z",
  "updatedAt": "2025-02-28T07:00:54.571Z",
  "events": [
    "incoming_whatsapp_message"
  ],
  "webhookHeaders": [
    {
      "key": "text",
      "value": "text"
    }
  ]
}

200 response

Update Webhook

Update an existing webhook subscription.

put

/v1/webhooks/{webhookId}

Authorizations

Path parameters

webhookIdstringrequired

Header parameters

x-api-keystringrequired

Body

idstring

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-time

Timestamp of endpoint creation

updatedAtstring · date-time

Timestamp of endpoint update

eventsstring · enum[]required

webhookHeadersobject[]

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request PUT \
  --url '<YOUR HOST>/v1/webhooks/{webhookId}' \
  --header 'x-api-key: text' \
  --header 'Content-Type: application/json' \
  --data '{
    "id": "text",
    "name": "text",
    "active": true,
    "serverUrl": "https://example.com",
    "createdAt": "2025-02-28T07:00:54.571Z",
    "updatedAt": "2025-02-28T07:00:54.571Z",
    "events": [
      "incoming_whatsapp_message"
    ],
    "webhookHeaders": [
      {
        "key": "text",
        "value": "text"
      }
    ]
  }'

200

200

{
  "id": "text",
  "name": "text",
  "active": true,
  "serverUrl": "https://example.com",
  "createdAt": "2025-02-28T07:00:54.571Z",
  "updatedAt": "2025-02-28T07:00:54.571Z",
  "events": [
    "incoming_whatsapp_message"
  ],
  "webhookHeaders": [
    {
      "key": "text",
      "value": "text"
    }
  ]
}

200 response

Delete Webhook

Remove a webhook subscription.

delete

/v1/webhooks/{webhookId}

Authorizations

Path parameters

webhookIdstringrequired

Header parameters

x-api-keystringrequired

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request DELETE \
  --url '<YOUR HOST>/v1/webhooks/{webhookId}' \
  --header 'x-api-key: text'

200

200

{
  "success": true
}

200 response