The message.received event is delivered whenever someone sends a message to a
Surge number you own.
Common Use Cases
- Trigger automated responses
- Update conversation analytics
- Send notifications to other systems
- Log customer interactions
Payload Structure
The ID of the account that received the message
Always message.received for this event
The unique identifier for the message
The content of the message
The unique identifier for the attachment
The type of the attachment. Can be one of file, image, link, or video
The URL where the attachment can be downloaded
ISO 8601 timestamp of when the message was received
The unique identifier for the conversation
The unique identifier for the contact
The first name of the contact, if it is known
The last name of the contact, if it is known
The contact’s phone number in E.164 format
