Skip to content
Nappai Documentation

ActiveCampaign Lists

This component helps you manage your contact lists in ActiveCampaign. You can create new lists, update list details, or remove lists that are no longer needed. It connects your Nappai automation to your ActiveCampaign account to keep your audience segments organized and up to date.

How it Works

This component acts as a bridge between Nappai and your ActiveCampaign account. When you run this component, it securely connects to ActiveCampaign using your credentials and performs actions on your contact lists. It sends instructions to create, view, update, or delete lists and then brings the results back to your workflow so you can use them in the next steps.

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 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 operation to perform.
  • Get By: Retrieve a single list by ID or all lists.
  • List Name: Name of the list.
  • List ID: ID of the list.
  • Limit: Maximum number of lists to return.
  • Sender URL: Required by ActiveCampaign. URL of your website or the page where subscribers signed up.
  • Sender Reminder: Required by ActiveCampaign. Short text reminding subscribers why they are on this list.

Outputs

  • Status: Indicates the result of the operation, such as success, updated, or error. You can use this to trigger different paths in your workflow based on whether the action worked.
  • List Data: Contains detailed information about the list, including its ID, name, creation date, and settings. You can use this data to connect to other components that need list information.
  • Error Message: Provides a description of any error that occurred. This helps you troubleshoot issues if the operation fails.
  • Response Code: Returns the HTTP status code (e.g., 200 for success, 404 for not found). This is useful for monitoring and auditing your automation.

Output Data Example (JSON)json

{ “id”: 54321, “name”: “Customer Updates”, “date_created”: “2023-11-15T10:30:00”, “tags”: [“sales”, “active”], “default_from_name”: “Nappai User”, “list_color”: “#FF5733” }

Connectivity

This component typically connects to actions that involve managing contacts or sending communications. For example, you can connect the List Data output to a component that adds contacts to the newly created list. It also works well before email marketing steps to ensure you are targeting the correct audience segment. Use the Status output to conditionally proceed only if the list operation was successful.

Usage Example

Scenario: Creating a New Newsletter List

  1. Add the ActiveCampaign Lists component to your workflow.
  2. Select your Credential that connects to your ActiveCampaign account.
  3. Set Operation to “Create List”.
  4. Enter a descriptive name in List Name, such as “Monthly Newsletter”.
  5. Provide your website URL in Sender URL (e.g., https://yourwebsite.com).
  6. Add a reminder text in Sender Reminder, such as “You signed up for our monthly updates.”
  7. Run the workflow. The component will create the list and return the list details in the List Data output, which you can then use to add subscribers.

Tips and Best Practices

  • Use clear and unique names for your lists to easily identify them later.
  • Always provide the Sender URL and Sender Reminder when creating or updating lists, as these are required by ActiveCampaign.
  • Check the Status output after running the component to confirm the action completed successfully.
  • If you need to update or delete a specific list, ensure you have the correct List ID from a previous step.
  • Be mindful of rate limits; ActiveCampaign may restrict too many requests in a short time.

Security Considerations

Keep your API keys secure and never share them. Nappai handles credentials securely within the panel, so only authorized workflows can access your ActiveCampaign data. Ensure you only use this component in trusted workflows to protect your contact information.