GoHighLevel Conversations API

Get Conversation

GET/conversations/:conversationId

GET /conversations/:conversationId Get the conversation details based on the conversation ID It takes 1 path parameter, requires the conversations.readonly scope and authenticates with a sub-account (location) token.

Request and authentication

Method: GET
Full URL: https://services.leadconnectorhq.com/conversations/:conversationId
Scopes: conversations.readonly
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

Path parameters

Substituted into the URL. Required by definition.

Name	Type	Description
`conversationId`required	`string`	Example: `tDtDnQdgm2LXpyiqYvZ6`

Response fields

Top-level fields returned on a successful call.

Name	Type	Description
`contactId`required	`string`	Unique identifier of the contact associated with this conversation Example: `ve9EPM428kjkvShlRW1KT`
`locationId`required	`string`	Unique identifier of the business location where this conversation takes place Example: `ve9EPM428kjkvShlRW1KT`
`deleted`required	`boolean`	Flag indicating if this conversation has been moved to trash/deleted Example: `false`
`inbox`required	`boolean`	Flag indicating if this conversation is currently in the main inbox view Example: `true`
`type`required	`number`	Communication channel type for this conversation: 1 (Phone), 2 (Email), 3 (Facebook Messenger), 4 (Review), 5 (Group SMS), 6 (Internal Chat - coming soon)
`unreadCount`required	`number`	Number of messages in this conversation that have not been read by the user Example: `1`
`assignedTo`	`string`	Unique identifier of the team member currently responsible for handling this conversation Example: `ve9EPM428kjkvShlRW1KT`
`id`required	`string`	Unique identifier for this specific conversation thread Example: `ve9EPM428kjkvShlRW1KT`
`starred`	`boolean`	Flag indicating if this conversation has been marked as important/starred by the user Example: `true`

Example request

Copy-paste ready. Swap YOUR_TOKEN for your access token or Private Integration Token, and the sample ID for your own.

curl -X GET 'https://services.leadconnectorhq.com/conversations/tDtDnQdgm2LXpyiqYvZ6' \
  -H 'Authorization: Bearer YOUR_TOKEN' \
  -H 'Version: 2021-07-28'

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