{
  "account_id": "acct_01japd271aeatb7txrzr2xj8sg",
  "data": {
    "id": "cnv_01jav8xy7fe4nsay3c9deqxge9",
    "contact": {
      "id": "ctc_01ja88cboqffhswjx8zbak3ykk",
      "last_name": "Dominic",
      "first_name": "Toretto",
      "phone_number": "+18015551234"
    }
  },
  "type": "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": "acct_01japd271aeatb7txrzr2xj8sg",
  "data": {
    "id": "cnv_01jav8xy7fe4nsay3c9deqxge9",
    "contact": {
      "id": "ctc_01ja88cboqffhswjx8zbak3ykk",
      "last_name": "Dominic",
      "first_name": "Toretto",
      "phone_number": "+18015551234"
    }
  },
  "type": "conversation.created"
}
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

contact
contact