GoHighLevel Conversations API

User Subscription Change

POST/conversations/preferences/unsubscriptions/user-change

POST /conversations/preferences/unsubscriptions/user-change Process subscription change initiated by a user (admin/agent). Supports individual custom subscription changes and resub all functionality. Legal forms are automatically created for user-initiated resubscribe actions on custom subscriptions It takes 6 body fields.

Request and authentication

Method: POST
Full URL: https://services.leadconnectorhq.com/conversations/preferences/unsubscriptions/user-change
Scopes: Not listed in HighLevel's published schema for this endpoint. See all OAuth scopes.
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
`locationId`required	`string`	Location Id Example: `ve9EPM428h8vShlRW1KT`
`contactId`required	`string`	Contact Id Example: `OP7z4LCyPACyH5fcEIZa`
`email`required	`string`	Email address Example: `user@example.com`
`subscription_action`required	`unknown`	Subscription action details
`legal_reason`	`string`	Legal reason for the change (required only for resubscribe and resub_all actions) Example: `User requested resubscribe via customer service`
`legal_description`	`string`	Legal description/details Example: `Customer called support on 2024-01-15 requesting to be removed from newsletter`

Example request

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

curl -X POST 'https://services.leadconnectorhq.com/conversations/preferences/unsubscriptions/user-change' \
  -H 'Authorization: Bearer YOUR_TOKEN' \
  -H 'Version: 2021-07-28' \
  -H 'Content-Type: application/json' \
  -d '{
    "locationId": "ve9EPM428h8vShlRW1KT",
    "contactId": "OP7z4LCyPACyH5fcEIZa",
    "email": "user@example.com"
  }'

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