Skip to content

Developers

Webhooks

Subscribe endpoints to receive JSON payloads in real time. Retries follow exponential backoff and signatures use HMAC SHA-256.

Webhooks backdrop

lead_submitted

Sample payload:

{
  "id": "lead_123",
  "form_id": "contact",
  "vertical": "smb",
  "source": "website",
  "utm": {"campaign": "smb-march"}
}

trial_started

Sample payload:

{
  "org_id": "org_789",
  "plan": "launch",
  "timestamp": "2025-03-01T14:22:05Z"
}

demo_booked

Sample payload:

{
  "timeslot": "2025-03-03T19:00:00Z",
  "vertical": "healthcare",
  "sales_rep": "rep_22"
}

consent_updated

Sample payload:

{
  "contact_id": "contact_456",
  "channel": "sms",
  "status": "opt_out",
  "reason": "keyword"
}

Security

Verify signatures with the `X-QOTBOT-Signature` header. Rotate secrets in the console and monitor delivery in the webhook dashboard.