Skip to main content
Fires when a tag is added to or removed from a contact. This is one of the most flexible triggers — use it to start campaigns, run onboarding sequences, or react to status changes.

​
When it fires

The trigger fires immediately when:
  • A tag is added to a contact (manually, via API, or from another workflow)
  • A tag is removed from a contact
You configure whether the workflow responds to additions, removals, or both.

​
Configuration

​
Tag event

Choose the event type:
EventDescription
Tag AddedFires when a tag is added to a contact
Tag RemovedFires when a tag is removed from a contact
You can create separate workflows for additions and removals, or use a single workflow with a Condition to branch.

​
Tag filter

Select which tags should trigger the workflow:
SettingDescription
Specific tagsSelect one or more tags from the dropdown. The workflow only fires when one of these tags is added/removed.
Any tagLeave the tag filter empty. The workflow fires on any tag change.

​
Examples

Only fire on “hot-lead” tag:
  • Event: Tag Added
  • Tag: Select “hot-lead” from dropdown
Fire when any tag is removed:
  • Event: Tag Removed
  • Tag: Leave empty (matches all)
Fire on multiple tags:
  • Event: Tag Added
  • Tags: Select “interested”, “qualified”, “ready-to-buy”

​
Data available

VariableDescriptionExample
{{contactId}}The contact’s IDa1b2c3d4-...
{{firstName}}Contact’s first nameJohn
{{lastName}}Contact’s last nameDoe
{{phone}}Contact’s phone number+14155551234
{{email}}Contact’s emailjohn@example.com
{{trigger.tag.id}}The tag’s IDt1a2b3c4-...
{{trigger.tag.name}}The tag’s namehot-lead
{{trigger.tag.mode}}Whether it was added or removedadded

​
Deduplication

Uses the contact ID + tag ID as the dedup key. Default window: 1 minute. If the same tag is toggled on and off quickly, only the first event triggers the workflow.

​
Use case examples

​
Start outreach when tagged “hot lead”

A sales rep tags a contact → the agent calls them automatically.
  1. Trigger: Contact tagged → Tag Added → “hot-lead”
  2. Action: Voice call — Sales agent
  3. Action: Condition — Check call outcome
    • Outcome = no_answer: Send SMS — “Hi {{firstName}}, I just tried to reach you. When’s a good time to chat?”
    • Outcome = voicemail: Wait 4 hours → Voice call retry
    • Default: Update contact — Add “contacted” tag

​
Onboarding drip sequence

New customer tagged → send a series of emails over several days.
  1. Trigger: Contact tagged → Tag Added → “new-customer”
  2. Action: Send email — Welcome email
  3. Action: Wait — 1 day
  4. Action: Send email — Getting started guide
  5. Action: Wait — 3 days
  6. Action: Voice call — Onboarding check-in agent

​
Notify team when tag removed

When a VIP tag is removed, alert the team.
  1. Trigger: Contact tagged → Tag Removed → “vip”
  2. Action: Slack message — “{{firstName}} {{lastName}} is no longer a VIP. Tag was removed.”
  3. Action: Send webhook — Update CRM status