Skip to content
Nappai Documentation

ActiveCampaign Tags

This component allows you to manage tags within your ActiveCampaign account. Tags are essential for categorizing contacts, segmenting audiences, and driving personalized automation. By using this component, you can create, update, retrieve, or organize your tags directly from your Nappai dashboard without needing to write code. It connects securely to the ActiveCampaign API to ensure your tag data is always up to date.

How it Works

This component acts as a bridge between Nappai and ActiveCampaign. When you configure it, it sends requests to the ActiveCampaign system based on the information you provide. Depending on your inputs, it can create a new tag, modify an existing one, fetch details about a specific tag, or retrieve a list of tags. The component handles the API communication behind the scenes and returns the results, which you can use in subsequent steps of your automation.

Connection & Credentials

This component requires configuring a credential in the Nappai panel before interacting with the external service:

  1. Go to the Credentials section in your Nappai panel.
  2. Create a new credential of the type ActiveCampaign and fill in the required fields (API URL and API Key). You can find these details in your ActiveCampaign account under Settings > Developer.
  3. In your workflow, select the saved credential in the Credential input field of this node.

Inputs

Input Fields

The following fields are available to configure this component:

  • Operation: Select the type of action you want to perform.
  • Get By: Choose how you want to retrieve tag information, such as by ID or as a list.
  • Tag Name: Enter the name of the tag.
  • Tag ID: Enter the unique ID of the tag.
  • Limit: Set the maximum number of tags to return.
  • Tag Type: Select the category type for the tag.
  • Description: Add a description to the tag.

Outputs

The component produces the following result:

  • Data: Returns the information related to the tag operation, such as the details of a created or updated tag.

Output Data Example (JSON)json

{ “id”: 12345, “name”: “Premium Customer”, “description”: “Tag for high-value recurring customers”, “type”: “default”, “date_created”: “2024-05-20 10:00:00”, “account_id”: 98765 }

Connectivity

This component is typically used to set up or retrieve tag structures before performing other actions. The Data output can be connected to other components that manage contacts, send emails, or apply conditions based on tag values. For example, you might use this component to verify a tag exists before adding a contact to a campaign that requires specific tagging.

Usage Example

Scenario: Creating a New Tag for a Newsletter Imagine you want to create a tag to identify subscribers who opt-in to your monthly newsletter.

  1. Set Operation to create or add a tag.
  2. Enter Tag Name as Newsletter Subscriber.
  3. Enter a Description like Users who receive the monthly update.
  4. Select your ActiveCampaign credential.
  5. Run the workflow. The component will create the tag in ActiveCampaign. You can then use the Data output to confirm the tag was created or pass this information to other parts of your automation.

Tips and Best Practices

  • Always ensure your Credential is correctly configured to avoid connection errors.
  • Use clear and unique names for your tags to keep your account organized and avoid conflicts.
  • If you are retrieving a large list of tags, use the Limit field to control the amount of data returned and improve performance.
  • Add descriptive notes in the Description field to help your team understand the purpose of each tag.

Security Considerations

  • Ensure your API Key is kept secret and only shared with trusted workflows. Use the Nappai credential system to store your API key securely, so it is not exposed in plain text within your workflow logic.