Contact Tagging

Use these tools to organize individual contacts with existing manual tags. Tags can represent interests, lifecycle stages, customer characteristics, or any other classification that supports segmentation and automation.

For example, you can add a tag when a contact reaches a particular stage or remove one when a classification is no longer valid. Because tag changes may influence campaigns and other automated processes, their wider impact should always be considered.

MCP tools

Assign Manual Tag

Tool name: tag-contact

Assigns an existing manual tag to a contact; this may start campaigns, outbound events or automations. Requires approval of those effects; does not create tags.

Input schema

contactIdinteger, >= 1required

Numeric contact ID returned by search-contacts

manualTagIdinteger, >= 1required

Existing writable manual tag ID; unknown tags are rejected and never created

approvalstringrequired

Exactly I_ACCEPT_AUTOMATION_EFFECTS: tagging may start campaigns and automations

Value:"I_ACCEPT_AUTOMATION_EFFECTS"

referenceIdinteger, >= 0

Reference for a multi-value manual tag; use 0 for contact-wide tags

Default:0

accountIdnull or integer, >= 1

User ID of the account; omit for the account the access token works in

Default:null

Input example

{
  "contactId": 1,
  "manualTagId": 1,
  "approval": "I_ACCEPT_AUTOMATION_EFFECTS",
  "referenceId": 0,
  "accountId": null
}

Output schema

accountIdintegerrequired

contactIdintegerrequired

manualTagIdintegerrequired

referenceIdintegerrequired

actionstringrequired

automationEffectstringrequired

editUrlstringrequired

Output example

{
  "accountId": 0,
  "contactId": 0,
  "manualTagId": 0,
  "referenceId": 0,
  "action": "string",
  "automationEffect": "string",
  "editUrl": "string"
}