API reference · Account

Configure webhooks

Set where events go and which ones you want.

PUT/v1/developer/webhooks

Bearer API key
Rate limit 120 / min
Returns 200 OK
Needs the SMS, WhatsApp or Email permission · free

PUT /v1/developer/webhooks

curl -X PUT https://api.talks.africa/v1/developer/webhooks \
  -H "Authorization: Bearer $TALKS_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://api.dukafresh.co.ke/hooks/talks",
    "subscribed_events": [
      "sms.delivered",
      "sms.failed",
      "whatsapp.received"
    ]
  }'

{
  "url": "https://api.dukafresh.co.ke/hooks/talks",
  "subscribed_events": [
    "sms.delivered",
    "sms.failed",
    "whatsapp.received"
  ]
}

Use a tk_test_ key while you build. Nothing is sent and no credits are used.

Body parameters

urlstringrequired
Your HTTPS endpoint.
subscribed_eventsstring[]required
Events to receive.

Response fieldsResponse

url
Your endpoint
subscribed_events
Your events

Errors

Tap one to see its response above.

All errors use the standard error object. Select one to see its response.

Was this page helpful?