PingStackDevelopers
DocsEvents & Webhooks

Outbound Developer Webhooks

Subscribe to real-time events for incoming customer messages, delivery receipts, and campaign updates.

5 min read•API v1

Supported Event Types

PingStack emits real-time HTTP POST webhooks for the following domain events: * `message.received` — A customer sent a WhatsApp message to your number. * `message.sent` — A message was accepted by Meta Cloud API. * `message.delivered` — Delivered to the recipient's phone. * `message.read` — Read by the recipient. * `message.failed` — Delivery failed (includes Meta error code). * `campaign.started` — Broadcast execution started in background. * `campaign.completed` — Broadcast execution finished. * `contact.created` / `contact.updated` / `contact.deleted` — Contact database mutations. * `ping` — Verification ping emitted during webhook setup/testing.

Registering a Webhook Endpoint

`POST /api/v1/webhooks`
curl -X POST https://app.pingstack.in/api/v1/webhooks \
  -H "Authorization: Bearer ps_secret_live_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://api.mycrm.com/webhooks/pingstack",
    "events": ["message.received", "message.delivered", "message.failed"]
  }'
PreviousCampaigns & BroadcastsNextSignature Verification