Skip to main content
POST
/
conversations
/
messages
/
inbound
Add an inbound message
curl --request POST \
  --url https://services.leadconnectorhq.com/conversations/messages/inbound \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'Version: <version>' \
  --data '
{
  "type": "SMS",
  "conversationId": "ve9EPM428h8vShlRW1KT",
  "conversationProviderId": "61d6d1f9cdac7612faf80753",
  "attachments": [
    "<string>"
  ],
  "message": "<string>",
  "html": "<string>",
  "subject": "<string>",
  "emailFrom": "sender@company.com",
  "emailTo": "<string>",
  "emailCc": [
    "john1@doe.com",
    "john2@doe.com"
  ],
  "emailBcc": [
    "john1@doe.com",
    "john2@doe.com"
  ],
  "emailMessageId": "<string>",
  "altId": "61d6d1f9cdac7612faf80753",
  "direction": [
    "outbound",
    "inbound"
  ],
  "date": "2023-11-07T05:31:56Z",
  "call": {
    "to": "+15037081210",
    "from": "+15037081210",
    "status": "completed"
  }
}
'
{
  "success": true,
  "conversationId": "ABC12h2F6uBrIkfXYazb",
  "messageId": "t22c6DQcTDf3MjRhwf77",
  "message": "<string>",
  "contactId": "<string>",
  "dateAdded": "2023-11-07T05:31:56Z",
  "emailMessageId": "<string>"
}

Authorizations

​
Authorization
string
header
required

Use the Access Token generated with user type as Sub-Account (OR) Private Integration Token of Sub-Account.

Headers

​
Version
enum<string>
required

API Version

Available options:
2021-04-15

Body

application/json
​
type
enum<string>
required

Message Type

Available options:
SMS,
Email,
WhatsApp,
GMB,
IG,
FB,
Custom,
WebChat,
Live_Chat,
Call
Example:

"SMS"

​
conversationId
string
required

Conversation Id

Example:

"ve9EPM428h8vShlRW1KT"

​
conversationProviderId
string
required

Conversation Provider Id

Example:

"61d6d1f9cdac7612faf80753"

​
attachments
string[]

Array of attachments

​
message
string

Message Body

​
html
string

HTML Body of Email

​
subject
string

Subject of the Email

​
emailFrom
string

Email address to send from. This field is associated with the contact record and cannot be dynamically changed.

Example:

"sender@company.com"

​
emailTo
string

Recipient email address. This field is associated with the contact record and cannot be dynamically changed.

​
emailCc
string[]

List of email address to CC

Example:
["john1@doe.com", "john2@doe.com"]
​
emailBcc
string[]

List of email address to BCC

Example:
["john1@doe.com", "john2@doe.com"]
​
emailMessageId
string

Send the email message id for which this email should be threaded. This is for replying to a specific email

​
altId
string

external mail provider's message id

Example:

"61d6d1f9cdac7612faf80753"

​
direction
object

Message direction, if required can be set manually, default is outbound

Example:
["outbound", "inbound"]
​
date
string<date-time>

Date of the inbound message

​
call
object

Response

Created the message

​
success
boolean
required
​
conversationId
string
required

Conversation ID.

Example:

"ABC12h2F6uBrIkfXYazb"

​
messageId
string
required

This is the main Message ID

Example:

"t22c6DQcTDf3MjRhwf77"

​
message
string
required
​
contactId
string
​
dateAdded
string<date-time>
​
emailMessageId
string
Last modified on March 4, 2026