GoHighLevel Conversations API

Export Messages By Location

GET/conversations/messages/export

GET /conversations/messages/export Export messages for a specific location with cursor-based pagination support. Response includes messageType (string), source, and subType fields. The channel parameter is optional - if not provided, all non-email message types will be returned including activity messages (opportunity updates, appointments, etc.) It takes 10 query parameters, requires the conversations/message.readonly scope and authenticates with a sub-account (location) token.

Request and authentication

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

Query parameters

Appended to the URL as a query string.

Name	Type	Description
`locationId`required	`string`	—
`limit`	`number`	—
`cursor`	`string`	Example: `eyJwaXRJZCI6ImFiYy0xMjMiLCJsYXN0U29ydCI6WzE2NDY4NjQ0MDBdLCJsYXN0SWQiOiIxMjMifQ==`
`sortBy`	`string`	One of: `createdAt`, `updatedAt`
`sortOrder`	`string`	One of: `asc`, `desc`
`conversationId`	`string`	—
`contactId`	`string`	—
`channel`	`string`	One of: `Call`, `SMS`, `Email`, `WhatsApp`, `Instagram`, `Facebook`
`startDate`	`string`	—
`endDate`	`string`	—

Response fields

Top-level fields returned on a successful call.

Name Type Description

messagesrequired

array

Array of messages

nextCursor

string

Cursor for fetching next page. Null if no more results.

Example: eyJwaXRJZCI6ImFiYy0xMjMiLCJsYXN0U29ydCI6WzE2NDY4NjQ0MDBdLCJsYXN0SWQiOiIxMjMifQ==

totalrequired

number

Total number of messages matching the query

Example: 1234

Example request

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

curl -X GET 'https://services.leadconnectorhq.com/conversations/messages/export' \
  -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