Webhooks

Register event subscriptions in workspace Events settings. Deliveries include a signed payload verified with your subscription secret.

Create a subscription

POST /api/v1/pods/{podId}/events/subscriptions
{
  "url": "https://your-app.com/webhooks/pamphlet",
  "eventTypes": ["mail.replied", "contact.created"]
}

Event types

• mail.sent
• mail.delivered
• mail.bounced
• mail.replied
• campaign.enrolled
• contact.created
• prospect.created
• deal.updated
• agent.run.completed
• chat.session.created

Retries

Failed deliveries retry with exponential backoff. Return 2xx within 10 seconds to acknowledge receipt.

Signature verification

Each subscription receives a unique signing secret at creation. Verify the X-Pamphlet-Signature header with HMAC SHA-256 over the raw request body.

See webhook receiver example in the repository.