Webhooks

Currently, you can subscribe to the following events:

  • contact/updated
  • contact/created
  • contact/deleted
  • flow/enrolled
  • message/updated
  • error/occurred

Payload examples:

{
  "event":"contact/updated",
  "data":{
    "id": "646b8faba72d83cfac9724c2",
    "email":"[email protected]",
    "phone":"+49182381238",
    "firstname":"Max",
    "lastname":"Mustermann",
    "consent":"double",
    "tags":[{"label":"Agency","id":"643e6d91815051a97f293738"}],
  }
}
{
  "event":"contact/created",
  "data":{
    "id": "646b8faba72d83cfac9724c2",
    "email":"[email protected]",
    "phone":"+49182381238",
    "firstname":"Max",
    "lastname":"Mustermann",
    "consent":"double",
    "tags":[{"label":"Agency","id":"643e6d91815051a97f293738"}],
  }
}
{
  "enrolledAt":"2024-02-15T15:48:30.911Z",
  "contactId":"646b8faba72d83cfac9724c2",
  "flowId":"65cb2a537df386bc1863baf8"
}
{
  "event":"contact/updated",
  "data":{
    "id": "646b8faba72d83cfac9724c2",
    "externalId":"<your-external-id>"
  }
}
{
  "event":"message/updated",
  "data":{
    "id": "wamid.HBgMNDM2NzYzOTQxNzk5FQIAERgSMjM4QkVEN0Y3QTA4QUFBOEEzAA==",
    "from": "business",
    "text": "test",
    "timestamp": 1726854811098,
    "footer": "",
    "header": "",
    "status": "delivered",
    "messageType": "text",
    "error": null,
    "chatId":"646b8faba72d83cfac9724c2",
    "contactId":"66edb6b92caf50d6312873bc"
  }
}
{
  event: 'error/occurred',
  data: {
    error: {
      message: 'Message failed to send because more than 24 hours have passed since the customer last replied to this number.',
      code: 131047,
      statusCode: 131047
    },
    source: {
      type: 'flow',
      id: '679a36372635fsc527628c07',
      stepId: 172536898803
    },
    contact: {
      id: '6748399d3yi45662c585232e',
      phone: '+49264536289243565',
      email: '[email protected]',
      firstName: 'Mike',
      lastName: 'Zack'
    },
    metadata: {
      messageId: 'wamid.HBgMMASrfyg56ODgwFQIAERgSQ0I5MEYwQUU5Mzk0MzE4OEQzAA==',
      isNonRetryableError: true
    },
    occurredAt: '2026-02-06T13:25:14.200Z'
  }
}