GoHighLevel Contacts API

Create Association

POST/contacts/bulk/tags/update/:type

POST /contacts/bulk/tags/update/:type Allows you to update tags to multiple contacts at once, you can add or remove tags from the contacts It takes 4 body fields.

Request and authentication

Method: POST
Full URL: https://services.leadconnectorhq.com/contacts/bulk/tags/update/:type
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
`contacts`required	`array`	list of contact ids to be processed Example: `qFSqySFkVvNzOSqgGqFi,abcdef,qFSqySFkVvNzOSqgGqFi,3ualbhnV7j3n3a9r2moD`
`tags`required	`array`	list of tags to be added or removed Example: `tag-1,tag-2`
`locationId`required	`string`	location id from where the bulk request is executed Example: `asdrwHvLUxlfw5SqKVCN`
`removeAllTags`	`boolean`	Option to implement remove all tags. if true, all tags will be removed from the contacts. Can only be used with remove type. Example: `false`

Response fields

Top-level fields returned on a successful call.

Name Type Description

succededrequired

boolean

Indicates if the operation was successful

Example: true

errorCountrequired

number

Number of errors encountered during the operation

Example: 0

responsesrequired

array

Responses for each contact processed

Example: [object Object],[object Object],[object Object],[object Object]

Example request

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

curl -X POST 'https://services.leadconnectorhq.com/contacts/bulk/tags/update/:type' \
  -H 'Authorization: Bearer YOUR_TOKEN' \
  -H 'Version: 2021-07-28' \
  -H 'Content-Type: application/json' \
  -d '{
    "contacts": [
      "qFSqySFkVvNzOSqgGqFi",
      "abcdef",
      "qFSqySFkVvNzOSqgGqFi",
      "3ualbhnV7j3n3a9r2moD"
    ],
    "tags": [
      "tag-1",
      "tag-2"
    ],
    "locationId": "asdrwHvLUxlfw5SqKVCN"
  }'

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 contacts endpoints