HappierleadsDocs
MCP server

create_tag

Create a new tag on a website so you can label leads with tag_lead.

Create a tag · Changes data

Create a new tag on a website so you can label leads with tag_lead. The name is stored in upper case and must be unique on the website (a duplicate returns 'Tag text already exist'). websiteId comes from list_websites. Check list_tags first to reuse an existing tag. Returns status 'Successful' and tagId.

ConnectionAccount URL, team member URL or OAuth

Parameters

ParameterTypeRequiredDescription
websiteIdstringYesWebsite id (24 hex characters) from list_websites.
namestringYesTag name, e.g. "Hot account" (saved as "HOT ACCOUNT").
colorstringNoHex colour as #RRGGBB, e.g. "#059669". Default "#1E4EFF". Any other format is refused.

Tool definition

What your assistant receives from tools/list:

{
  "name": "create_tag",
  "title": "Create a tag",
  "annotations": {
    "title": "Create a tag",
    "readOnlyHint": false,
    "destructiveHint": false,
    "idempotentHint": true,
    "openWorldHint": false
  },
  "inputSchema": {
    "type": "object",
    "properties": {
      "websiteId": {
        "type": "string",
        "description": "Website id (24 hex characters) from list_websites."
      },
      "name": {
        "type": "string",
        "description": "Tag name, e.g. \"Hot account\" (saved as \"HOT ACCOUNT\")."
      },
      "color": {
        "type": "string",
        "description": "Hex colour as #RRGGBB, e.g. \"#059669\". Default \"#1E4EFF\". Any other format is refused."
      }
    },
    "required": [
      "websiteId",
      "name"
    ]
  }
}

On this page