Skip to content

Webhooks

Agora webhooks let your server receive real-time HTTP POST notifications whenever events occur in your campaigns — lead created, call completed, form submitted, and more.

  • Quick Start

    Get a live ping delivery to a test URL in under 5 minutes.

    Quick start

  • Signature Verification

    Verify every request came from Agora using HMAC-SHA256.

    Python · Node.js · Ruby examples

  • Event Reference

    All event types, request headers, payload shapes, and delivery behaviour.

    Event reference

  • REST API

    Full REST API for managing endpoints and replaying deliveries.

    API reference

How it works

Campaign event fires
        │
        ▼
Agora signs payload with HMAC-SHA256
        │
        ▼
POST to your endpoint  ──►  Your server verifies signature
        │                              │
        │                     returns 2xx within 10s
        │
  non-2xx / timeout?
        │
        ▼
  One automatic retry
        │
        ▼
  Recorded in Deliveries panel

Idempotency

Because of the automatic retry, your handler may receive the same event twice. Build it to be idempotent — see How to handle duplicate deliveries.