HighLevel

Add HighLevel Tag to Contact

Adds a tag to a contact in HighLevel.

Unverified

What the model is told

Add a tag to an existing HighLevel contact. Use only a tag name you have been told to use, and confirm with the customer before tagging them. Find the contact's ID first with Find HighLevel Contact by Email. Existing tags are kept. Returns the contact's tags.

Request

POSThttps://services.leadconnectorhq.com/contacts/{{contactId}}/tags

Headers

  • AuthorizationBearer YOUR_HIGHLEVEL_PRIVATE_INTEGRATION_TOKEN
  • Versionv3
  • Content-Typeapplication/json

Body

{
  "tags": [
    "{{tag}}"
  ]
}

Parameters

  • contactId stringThe HighLevel ID of the contact, from Find HighLevel Contact by Email.
  • tag stringThe name of the tag to add.

Engage payload

{
  "source": "VOICE_AI",
  "tool": {
    "id": "fd7aabdd-01aa-447e-8779-9972c2589141",
    "type": "HTTP_REQUEST",
    "label": "Add HighLevel Tag to Contact",
    "name": "add_highlevel_tag_to_contact",
    "customName": false,
    "description": "Add a tag to an existing HighLevel contact. Use only a tag name you have been told to use, and confirm with the customer before tagging them. Find the contact's ID first with Find HighLevel Contact by Email. Existing tags are kept. Returns the contact's tags.",
    "parameters": [
      {
        "name": "contactId",
        "type": "string",
        "description": "The HighLevel ID of the contact, from Find HighLevel Contact by Email."
      },
      {
        "name": "tag",
        "type": "string",
        "description": "The name of the tag to add."
      }
    ],
    "config": {
      "endpoint": {
        "method": "POST",
        "url": "https://services.leadconnectorhq.com/contacts/{{contactId}}/tags"
      },
      "headers": [
        {
          "name": "Authorization",
          "value": "Bearer YOUR_HIGHLEVEL_PRIVATE_INTEGRATION_TOKEN"
        },
        {
          "name": "Version",
          "value": "v3"
        },
        {
          "name": "Content-Type",
          "value": "application/json"
        }
      ],
      "body": "{\n  \"tags\": [\n    \"{{tag}}\"\n  ]\n}",
      "timeout": null
    }
  }
}

IDs are regenerated on every copy.