WebhooksEvents

Conversation Created

The conversation.created event is delivered whenever a new conversation is started with a contact. This could be when either the contact sends a message to your Surge number or when you create a conversation, whether by sending an initial message to the contact or by manually creating the conversation using the API.

Common Use Cases

  • Initialize conversation tracking
  • Trigger welcome workflows
  • Update contact management systems
  • Start conversation analytics

Payload Structure

account_id
string

The ID of the account where the conversation was created

type
string

Always conversation.created for this event

data
conversation
id
string

The unique identifier for the conversation

phone_number
phone_number

The Surge phone number from which messages will be exchanged with the contact

id
string

The unique identifier for the phone number

number
string

The E.164 representation of the phone number

type
enum

The type of the phone number. Can be one of local, toll_free, short_code, or demo

contact
contact
id
string

The unique identifier for the contact

first_name
string

The first name of the contact, if it is known

last_name
string

The last name of the contact, if it is known

phone_number
string

The contact’s phone number in E.164 format