GoHighLevel Conversations API

Add An Inbound Message

POST/conversations/messages/inbound

POST /conversations/messages/inbound Post the necessary fields for the API to add a new inbound message. It takes 17 body fields, requires the conversations/message.write scope and authenticates with a sub-account (location) token.

Request and authentication

Method: POST
Full URL: https://services.leadconnectorhq.com/conversations/messages/inbound
Scopes: conversations/message.write
Token type: Sub-account (location) token
Accepted auth: OAuth Access Token, Private Integration Token
API version header: Version: 2021-07-28
Schema verified: 22 June 2026

Request body

JSON body fields. Nested objects are shown indented under their parent.

Name	Type	Description
`type`required	`string`	Message Type One of: `SMS`, `RCS`, `Email`, `WhatsApp`, `GMB`, `IG`, `FB`, `Custom`, `WebChat`, `Live_Chat`, `Call`, `IVR_Call`, `Campaign_Call`, `Campaign_VoiceMail`, `TIKTOK`, `ALL_IN_ONE_CHAT`, `FORM_SUBMISSION` Example: `SMS`
`attachments`	`array`	Array of attachments
`message`	`string`	Message Body
`conversationId`required	`string`	Conversation Id Example: `ve9EPM428h8vShlRW1KT`
`contactId`required	`string`	Contact Id Example: `ve9EPM428h8vShlRW1KT`
`conversationProviderId`required	`string`	Conversation Provider Id Example: `61d6d1f9cdac7612faf80753`
`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`	`array`	List of email address to CC Example: `john1@doe.com,john2@doe.com`
`emailBcc`	`array`	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 of the inbound message
`call`	`unknown`	Phone call dialer and receiver information

Response fields

Top-level fields returned on a successful call.

Name	Type	Description
`success`required	`boolean`	—
`conversationId`required	`string`	Conversation ID. Example: `ABC12h2F6uBrIkfXYazb`
`messageId`required	`string`	This is the main Message ID Example: `t22c6DQcTDf3MjRhwf77`
`message`required	`string`	—
`contactId`	`string`	—
`dateAdded`	`string`	—
`emailMessageId`	`string`	—

Example request

Copy-paste ready. Swap YOUR_TOKEN for your access token or Private Integration Token.

curl -X POST 'https://services.leadconnectorhq.com/conversations/messages/inbound' \
  -H 'Authorization: Bearer YOUR_TOKEN' \
  -H 'Version: 2021-07-28' \
  -H 'Content-Type: application/json' \
  -d '{
    "type": "SMS",
    "conversationId": "ve9EPM428h8vShlRW1KT",
    "contactId": "ve9EPM428h8vShlRW1KT",
    "conversationProviderId": "61d6d1f9cdac7612faf80753"
  }'

Skip the schema lookup

Hylo gives your AI agent this schema — and the other 52 documented here — without you looking anything up. Ask in plain English; it picks the endpoint, fills the body, and can run the call against your own sub-account.

View pricing Read the setup guide

More conversations endpoints