contact.created
A contact was added.
Fires when someone writes for the first time on any channel that identifies them, a team member adds a contact by hand, or a flow's hook names a number that was not yet a contact.
Does not fire for contacts brought in by a CSV or WhatsApp import — one click would be thousands of events. Not for web widget visitors, who have no contact.
Header Parameters
t=<unix seconds>,v1=<hex HMAC-SHA256 of "{t}.{body}">, with a second v1 while a rotated secret still signs. Verify it before trusting the body.
The event's type, so a receiver can route before parsing.
This delivery's id. A resend of the same event keeps the envelope id and gets a new delivery id.
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Every event arrives in this envelope. Fields are only ever added, and a field that can be empty is sent as null rather than left out. Deduplicate on id: a delivery can arrive more than once.
Response Body
Example Requests
/contact.created