Skip to main content
POST
/
v1
/
api
/
webhooks
Create Webhook
curl --request POST \
  --url https://api.withallo.com/v1/api/webhooks \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "allo_number": "+1234567890",
  "url": "https://example.com/webhooks/allo",
  "topics": [
    "CALL_RECEIVED",
    "SMS_RECEIVED"
  ],
  "enabled": true
}
'
{
  "data": {
    "id": "web-2NfDKEm9sF8xK3pQr1Zt",
    "alloNumber": "+1234567890",
    "enabled": true,
    "url": "https://example.com/webhooks/allo",
    "topics": [
      "CALL_RECEIVED",
      "SMS_RECEIVED"
    ]
  }
}

Authorizations

​
Authorization
string
header
required

Scope needed: WEBHOOKS_READ_WRITE

Body

application/json

Request body for creating a webhook configuration

​
allo_number
string
required

The Allo phone number to create the webhook for (E.164 format)

Example:

"+1234567890"

​
url
string<uri>
required

The webhook URL endpoint to receive events

​
topics
enum<string>[]
required

List of webhook topics to subscribe to

Available options:
PING,
CALL_RECEIVED,
SMS_RECEIVED,
SMS_SENT
​
enabled
boolean
default:true

Whether the webhook is enabled

Response

Webhook created successfully

Response containing the created webhook configuration

​
data
object