Add tag to contact
Identifier and availability
- Type:
action - Stable identifier:
contact_tag:add - Status: Selectable — available in the new-node selector and importable.
Purpose
Adds a selected tag to the current contact.
Prerequisites and context
Required configuration: contact_tag. Runtime requires a contact in context.
Parameters
| JSON path | Type | Required | Default | Allowed values | Description |
|---|---|---|---|---|---|
contact_tag |
contact_tag_reference | Yes | — | — | Exact tag name. Set create_if_missing=true to create the missing tag transactionally during import; runtime then uses the created tenant tag. |
Unknown parameter and settings keys are rejected. Resource references use names, emails, document keys, or endpoints rather than database IDs.
Inputs and available variables
This node declares no additional variable groups. The always-available date group and context inherited from its path still apply.
Templated strings use double braces, for example {{contact.first_name}}. Availability in the editor does not create runtime context; the trigger and preceding branch still need to provide it.
Connections and branches
This is a sequential action with no branch ports. A root placement uses from set to null and branch set to actions; a branch placement uses the branching action key and branch token. Use a 1-based order within that path.
Connection fragment:
{
"from": null,
"to": "action_contact_tag_add",
"branch": "actions",
"order": 1
}
Valid JSON node example
{
"key": "action_contact_tag_add",
"type": "action",
"name": "contact_tag:add",
"display_name": null,
"parameters": {
"contact_tag": {
"name": "VIP",
"create_if_missing": false
}
}
}
Validation and runtime caveats
The node runs only after its Automation is explicitly reviewed, published, and active.
See the Automation JSON import format for the envelope, dependency resolution, graph rules, complete examples, and AI author checklist.