Skip to content
Nappai Documentation

ActiveCampaign Tags

ActiveCampaign Tags manages the tags of your ActiveCampaign account, the labels you give contacts to segment them and trigger automations, such as customer, webinar-lead or vip. You can create a tag, look up one or all of them, change it and delete it.

To add a tag to a contact or remove it, use ActiveCampaign Contacts with Add Tag or Remove Tag.

When to use it

  • You need a tag’s ID to apply it to contacts from another component.
  • You are organizing a new event and want to create its tag before registrations start coming in.
  • You want to review the tags in your account to merge duplicates.
  • A campaign has ended and you want to delete the tag you no longer use.

Configuration

You need an ActiveCampaign credential with the API URL and the API key of your account. You find them in ActiveCampaign under Settings > Developer. See Credentials.

FieldWhat it does
Credential (required)The ActiveCampaign credential used to access your account.
Operation (required)What the component does. See Operations. Default: Get Tags.
Get ByOnly in Get Tags. By ID fetches one tag and All fetches all of them. Default: All.
Tag NameThe tag’s name. Required in Create Tag and Update Tag.
Tag IDThe tag’s ID. Required in Update Tag, Delete Tag and in Get Tags with By ID.
LimitOnly in Get Tags with All. The maximum number of tags to fetch. Default: 10.

Operations

OperationWhat it does
Create TagCreates a new tag.
Update TagChanges the name, type and description of an existing tag.
Get TagsFetches one tag or all of them.
Delete TagDeletes a tag.

Advanced options

FieldWhat it does
Tag TypeIn Create Tag and Update Tag. contact for contact tags and template for template tags. Default: contact.
DescriptionIn Create Tag and Update Tag. A description of what the tag is for.

Output

The Data output returns the tag you worked with, with its ID, name and type. With Get Tags set to All you get one item per tag. In Delete Tag it returns a confirmation with the ID.

You can pass the tag ID to ActiveCampaign Contacts to tag contacts. The component can also be connected to an Agent as a tool, so the agent decides when to look up or create tags. See Tool Mode.

Example

A consultancy runs a webinar and wants to tag the people who sign up.

  1. Add ActiveCampaign Tags with Create Tag and put webinar-october in Tag Name.
  2. When each registration arrives, use ActiveCampaign Contacts with Add Tag, the registrant’s Contact ID and the Tag ID of the new tag.

Good practices

  • In Update Tag, fill in only what you want to change: Tag Name or Description left empty keep their current value.