Skip to main content
POST
/
conversations
Create Conversation
curl --request POST \
  --url https://services.leadconnectorhq.com/conversations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'Version: <version>' \
  --data '
{
  "locationId": "tDtDnQdgm2LXpyiqYvZ6",
  "contactId": "tDtDnQdgm2LXpyiqYvZ6"
}
'
{
  "success": true,
  "conversation": {
    "id": "tDtDnQdgm2LXpyiqYvZ6",
    "dateUpdated": "2023-10-01T12:00:00Z",
    "dateAdded": "2023-10-01T12:00:00Z",
    "deleted": false,
    "contactId": "ve9EPM428kjkvShlRW1KT",
    "locationId": "ve9EPM428kjkvShlRW1KT",
    "lastMessageDate": "2023-10-01T12:00:00Z",
    "assignedTo": "ve9EPM428kjkvShlRW1KT"
  }
}

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
locationId
string
required

Location ID as string

Example:

"tDtDnQdgm2LXpyiqYvZ6"

contactId
string
required

Contact ID as string

Example:

"tDtDnQdgm2LXpyiqYvZ6"

Response

Successful response

success
boolean
required

Indicates whether the API request was successful.

Example:

true

conversation
object
required
Last modified on March 4, 2026