The message.received webhook event is triggered whenever a lead texts your phone number. This can be used to track incoming communication.

​
Payload

{
  "event": "message.received",
  "data": {
    "leadId": "c4f23a1b-d8e5-4f67-90c1-2a5b8d3e9x7y",
    "phone": "+12025550189",
    "profile": "Default Profile",
    "content": {
      "text": "hello, are you available?"
    }
  },
  "timestamp": "2024-01-15T14:30:00Z"
}

​
Properties

PropertyTypeDescription
eventstringThe webhook event type (message.received).
data.leadIdstringThe unique identifier for the lead.
data.phonestringThe phone number of the lead.
data.profilestringThe customer profile assigned to the lead.
data.content.textstringThe content of the message received from the lead.
timestampstringThe ISO 8601 timestamp when the message was received.