WebhooksEvents

Message Received

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

stringRequired

The ID of the account that received the message

stringRequired

Always message.received for this event

message
string

The unique identifier for the message

string

The content of the message

attachment[]
string

The unique identifier for the attachment

enum

The type of the attachment. Can be one of file, image, link, or video

string

The URL where the attachment can be downloaded

string

ISO 8601 timestamp of when the message was received

conversation
string

The unique identifier for the conversation

contact
string

The unique identifier for the contact

string

The first name of the contact, if it is known

string

The last name of the contact, if it is known

string

The contact’s phone number in E.164 format