GoHighLevel Conversations API

Update Custom Subtype

PUT/conversations/preferences/custom-subtypes/:id

PUT /conversations/preferences/custom-subtypes/:id Update or archive a custom subtype. Requires agency or account admin role It takes 1 path parameter, 1 query parameter and 4 body fields.

Request and authentication

Method: PUT
Full URL: https://services.leadconnectorhq.com/conversations/preferences/custom-subtypes/:id
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

Path parameters

Substituted into the URL. Required by definition.

Name	Type	Description
`id`required	`string`	Example: `ve9EPM428h8vShlRW1KT`

Query parameters

Appended to the URL as a query string.

Name	Type	Description
`locationId`required	`string`	Example: `ve9EPM428h8vShlRW1KT`

Request body

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

Name	Type	Description
`name`	`string`	Name of the custom subtype (max 100 characters) Example: `Newsletter Subscription`
`description`	`string`	Description of the custom subtype (max 100 characters) Example: `Updated weekly newsletter subscription preferences`
`archived`	`boolean`	Whether the custom subtype is archived Example: `false`
`resubscription_legal_form_id`	`string`	Resubscription legal form ID (optional when archiving) Example: `form_123456`

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 PUT 'https://services.leadconnectorhq.com/conversations/preferences/custom-subtypes/ve9EPM428h8vShlRW1KT' \
  -H 'Authorization: Bearer YOUR_TOKEN' \
  -H 'Version: 2021-07-28' \
  -H 'Content-Type: application/json' \
  -d '{
    "name": "Newsletter Subscription",
    "description": "Updated weekly newsletter subscription preferences",
    "archived": false
  }'

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