What Are Webhooks?
Webhooks are HTTP callbacks that TopCalls sends to your server when events occur. They’re the best way to integrate TopCalls with your existing systems.Real-Time Updates
Get notified instantly when calls complete, fail, or campaigns update. No polling required.
Complete Data
Receive full call details, transcripts, recordings, and analysis in a single webhook payload.
Reliable Delivery
Built-in retry logic ensures webhooks are delivered even if your server is temporarily unavailable.
Secure
Optional signature verification ensures webhooks are authentic and haven’t been tampered with.
Available Events
Call Events
| Event | When It Fires | Payload Includes |
|---|---|---|
call.queued | Call created and queued | Basic call info |
call.started | Call connected to recipient | Connection details |
call.completed | Call finished successfully | Full transcript, recording, summary |
call.failed | Call failed (busy, no answer, error) | Error details |
call.transferred | Call was transferred | Transfer destination |
Campaign Events
| Event | When It Fires | Payload Includes |
|---|---|---|
campaign.started | Campaign began running | Campaign config, lead count |
campaign.paused | Campaign was paused | Reason, pending leads |
campaign.resumed | Campaign resumed | Current stats |
campaign.completed | All leads processed | Final statistics |
campaign.stopped | Campaign was cancelled | Final statistics |
Webhook Timing
Successful Calls
Webhooks are sent ~15 seconds after call ends to ensure:- Recording URL is available
- Transcript is complete
- Call summary is generated (if configured)
Failed Calls
Webhooks are sent immediately when the call fails (no recording to wait for).Webhook Retries
TopCalls automatically retries failed webhook deliveries:- Initial attempt: Immediate
- Retry 1: After 1 minute
- Retry 2: After 5 minutes
- Retry 3: After 15 minutes
- Retry 4: After 1 hour