GoHighLevel Conversations API

Live Chat Agent Typing

POST/conversations/providers/live-chat/typing

POST /conversations/providers/live-chat/typing Agent/AI-Bot will call this when they are typing a message in live chat message It takes 4 body fields, requires the conversations/livechat.write scope and authenticates with a sub-account (location) token.

Request and authentication

Method
POST
Full URL
https://services.leadconnectorhq.com/conversations/providers/live-chat/typing
Scopes
conversations/livechat.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.

NameTypeDescription
locationIdrequiredstring

Location Id

Example: ve9EPM428h8vShlRW1KT

isTypingrequiredstring

Typing status

Example: true

visitorIdrequiredstring

visitorId is the Unique ID assigned to each Live chat visitor. visitorId will be added soon in GET Contact API

Example: ve9EPM428h8vShlRW1KT

conversationIdrequiredstring

Conversation Id

Example: ve9EPM428h8vShlRW1KT

Response fields

Top-level fields returned on a successful call.

NameTypeDescription
successrequiredboolean

Example request

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

curl -X POST 'https://services.leadconnectorhq.com/conversations/providers/live-chat/typing' \
  -H 'Authorization: Bearer YOUR_TOKEN' \
  -H 'Version: 2021-07-28' \
  -H 'Content-Type: application/json' \
  -d '{
    "locationId": "ve9EPM428h8vShlRW1KT",
    "isTyping": true,
    "visitorId": "ve9EPM428h8vShlRW1KT",
    "conversationId": "ve9EPM428h8vShlRW1KT"
  }'

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.

More conversations endpoints