Add contact tags - Automate.ax

highlevel.addContactTags adds tags to one contact.

automations/highlevel-add-contact-tags.automation.ts

import { automation, markSignificant } from "automate.ax"
import { highlevel } from "automate.ax/highlevel"

export default automation("Add contact tags", () => {
  markSignificant(
    highlevel.addContactTags({
      contactId: "sx6wyHhbFdRXh302LLNR",
      tags: [],
    }),
  )
})

Input

Field	Type	Required	Description
`contactId`	`string`	Yes	HighLevel contact id value.
`tags`	`string[]`	Yes	HighLevel tags value.

Automate.ax supplies the connected sub-account’s location ID. Optional second argument { account } selects a named HighLevel binding.

Output

Field	Type	Required	Description
`tags`	`string[]`	No	HighLevel tags value.

This action calls POST /contacts/{contactId}/tags with HighLevel API version 2021-07-28 and requires contacts.write. HighLevel validation and permission errors fail the action. Rate limits honor the provider’s retry timing.