Skip to main content

Contact Events

Events fired when contacts are created or modified. Every delivery uses the common envelope and headers described on the overview page.

contact.created​

Fired when a new contact is created (first message from a new customer).

Payload​

{
  "event": "contact.created",
  "timestamp": "2026-05-16T12:00:00.000Z",
  "webhook_id": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
  "data": {
    "contact_id": "uuid",
    "phone": "+918245678901",
    "name": "John Doe",
    "channel": "whatsapp",
    "created_at": "2026-05-16T12:00:00.000Z"
  }
}

contact.updated​

Fired when a contact's details are modified.

Payload​

{
  "event": "contact.updated",
  "timestamp": "2026-05-16T14:30:00.000Z",
  "webhook_id": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
  "data": {
    "contact_id": "uuid",
    "phone": "+918245678901",
    "name": "John D.",
    "labels": ["vip", "returning-customer"],
    "updated_at": "2026-05-16T14:30:00.000Z"
  }
}