Skip to main content
Webhooks allow you to receive real-time notifications when events occur in your Allo account.

​
Available Topics

Subscribe to the following webhook topics:
TopicDescription
PINGTest webhook connectivity
CALL_RECEIVEDTriggered when an inbound call is received
SMS_RECEIVEDTriggered when an SMS message is received
SMS_SENTTriggered when an SMS message is sent

​
Setting Up a Webhook

Use the Create or Update Webhook endpoint to configure your webhook: 
curl -X POST "https://api.withallo.com/v1/api/webhooks" \
  -H "Authorization: Api-Key YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "enabled": true,
    "url": "https://your-server.com/webhook",
    "topics": ["CALL_RECEIVED", "SMS_RECEIVED"]
  }'

​
Webhook Requirements

  • Your webhook URL must be publicly accessible
  • Your server should respond with a 200 status code within 30 seconds
  • Use HTTPS for secure communication