Skip to content
Nappai Documentation

ActiveCampaign Contacts

This component allows you to manage your ActiveCampaign contacts directly within Nappai. You can create new contacts, update existing information, search for specific people, and organize them into lists and tags. Use this component to automate your marketing campaigns, keep your customer data up to date, and sync information between your applications.

How it Works

This component acts as a bridge between Nappai and ActiveCampaign. When you run a workflow, it sends secure requests to ActiveCampaign to perform actions based on your inputs. For example, if you provide an email and a name, it can create a contact. If you provide a contact ID, it can update their details. The component also handles authentication internally using your API credentials and returns the results so you can use the data in further 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, API Key).
  3. In your workflow, select the saved credential in the Credential input field of this node.

How to get your credentials: Log in to your ActiveCampaign account, go to Settings > Developer, and copy your API URL and API Key.

Inputs

Input Fields

The following fields are available to configure this component:

  • Operation: Select the action you want to perform on contacts.
  • Search By: Choose the field used to search for a contact.
  • Get By: Retrieve a single user by ID or all users.
  • Email: The email address of the contact.
  • First Name: The first name of the contact.
  • Last Name: The last name of the contact.
  • Phone: The phone number of the contact.
  • Contact ID: The unique ID of the ActiveCampaign contact.
  • User ID: The unique ID of the ActiveCampaign user.
  • Tag ID: The ID of a tag to manage.
  • List ID: The ID of a list to manage.
  • Limit: The maximum number of users to return.
  • Custom Fields: Custom field values as a Data object with field IDs and values.

Outputs

  • Contact ID: The unique ID assigned to the contact.
  • Operation Status: Indicates if the operation was successful.
  • API Response Payload: Contains the data returned by the API.
  • Error Message: Details about any errors that occurred.
  • Contact Data: The full contact information.

Output Data Example (JSON)

json { “contact_id”: 123456789, “success”: true, “data”: { “email”: “user@example.com”, “first_name”: “Jane”, “last_name”: “Doe”, “tags”: [101, 102] }, “error”: null }

Connectivity

This component typically connects to workflow triggers or actions that capture user data, such as forms, webhooks, or database queries.

  • Connect the Email or Contact ID outputs to other components that need to use this information for further processing.
  • Use this component after a data collection step to automatically create or update contacts in ActiveCampaign.
  • You can chain this component with other ActiveCampaign nodes to perform more complex CRM automations.

Usage Example

Scenario: Create a new contact from a website form

  1. Use a Form component to collect Email and First Name from your visitors.
  2. Connect the email output to the Email input of this component.
  3. Connect the first name output to the First Name input.
  4. Set the Operation to create or update contact.
  5. The workflow will automatically add the person to your ActiveCampaign database and return the new Contact ID.

Tips and Best Practices

  • Ensure you have a valid ActiveCampaign credential configured before using this component.
  • Use Operation Status to check if actions succeeded and handle errors in your workflow.
  • Be aware that this component is marked for development. Review official ActiveCampaign documentation for any API updates or schema changes.
  • When managing tags or lists, ensure you have the correct IDs to avoid errors.
  • Use Custom Fields to map specific data points from your sources to matching fields in ActiveCampaign.

Security Considerations

  • Keep your API keys secure and only share them with trusted integrations.
  • This component handles authentication internally using the provided credentials. Never expose your API keys in workflow logs or public places.
  • Review your ActiveCampaign account settings to ensure the API key has the appropriate permissions for the actions you are performing.