PlatformDocs
MCP server

list_tags

List the tags available on a website: the website's own tags plus the built-in default tags.

View as Markdown

List tags · Read-only

List the tags available on a website: the website's own tags plus the built-in default tags. Each tag has _id (use it as tagId in tag_lead / remove_tags_from_lead), text (the name, in upper case; use it for the tag filter in get_leads) and colour. websiteId comes from list_websites. Create a new tag with create_tag. Returns { tags: [...] }. Read-only.

ConnectionAccount URL, team member URL or OAuth

Parameters

ParameterTypeRequiredAcceptsDescription
websiteIdstringYesanyWebsite id (24 hex characters) from list_websites.

Tool definition

What your assistant receives from tools/list:

{
  "name": "list_tags",
  "title": "List tags",
  "annotations": {
    "title": "List tags",
    "readOnlyHint": true,
    "destructiveHint": false,
    "idempotentHint": true,
    "openWorldHint": false
  },
  "inputSchema": {
    "type": "object",
    "properties": {
      "websiteId": {
        "type": "string",
        "description": "Website id (24 hex characters) from list_websites."
      }
    },
    "required": [
      "websiteId"
    ]
  }
}

Used in

On this page