ActiveCampaign Contacts

ActiveCampaign Contacts connects your flow to your ActiveCampaign account to work with contacts: add them, find them by ID or by email, change their details, delete them, add or remove a tag, and subscribe them to a list or remove them from it. It can also look up the users of your ActiveCampaign account, that is, the people on your team who can own a deal.

It is useful when contacts come from somewhere else, such as a web form, a store or a chat, and you want them to land in ActiveCampaign with their tags and lists without doing it by hand.

When to use it

Someone fills in the form on your website and you want to create the contact in ActiveCampaign and subscribe them to your newsletter list.
A customer buys a product and you want to give them the customer tag so they enter your ActiveCampaign automations.
An AI agent helps a customer in a chat and needs to find their record by email before answering.
A customer asks to unsubscribe and you want to remove them from a specific list without deleting the contact.
You want to know which users of your team exist in ActiveCampaign so you can assign deals to them later.

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.

Field	What it does
Credential (required)	The ActiveCampaign credential used to access your account.
Operation (required)	What the component does. See Operations. Default: `Create Contact`.
Search By	Only in `Get Contact`. `ID` finds the contact by its ID and `Email` by its email. Default: `ID`.
Get By	Only in `Get Users`. `By ID` fetches one user and `All` fetches the list of users. Default: `All`.
Email	The contact’s email. Required in `Create Contact` and in `Get Contact` with `Email`. In `Update Contact`, only if you want to change it.
First Name	The contact’s first name. In `Create Contact` and `Update Contact`.
Last Name	The contact’s last name. In `Create Contact` and `Update Contact`.
Phone	The contact’s phone number. In `Create Contact` and `Update Contact`.
Contact ID	The contact’s ID in ActiveCampaign. Required in every operation except `Create Contact`, `Get Users` and `Get Contact` with `Email`.
Tag ID	The tag’s ID. Required in `Add Tag` and `Remove Tag`.
List ID	The list’s ID. Required in `Add to List` and `Remove from List`.
User ID	The user’s ID. Required in `Get Users` with `By ID`.
Limit	Only in `Get Users` with `All`. The maximum number of users to fetch. Default: 10.

Operations

Operation	What it does
`Create Contact`	Creates a new contact with its email and the details you fill in.
`Update Contact`	Changes the details of an existing contact. Only the fields you fill in are changed; at least one must have a value.
`Get Contact`	Fetches a contact’s record, finding it by ID or by email.
`Delete Contact`	Deletes a contact.
`Add Tag`	Adds a tag to a contact.
`Remove Tag`	Removes a tag from a contact. If the contact did not have it, the component returns an error.
`Add to List`	Subscribes a contact to a list.
`Remove from List`	Unsubscribes a contact from a list. If they were not subscribed, the component returns an error.
`Get Users`	Fetches one user of your ActiveCampaign account or the list of users.

Advanced options

Field	What it does
Custom Fields	Values for the contact’s custom fields, as pairs of field ID and value. Applied when you create the contact with `Create Contact`.

Output

The Contact Data output returns the contact you worked with: its ID, email, name and the other details ActiveCampaign stores. In Delete Contact, Add Tag, Remove Tag, Add to List and Remove from List it returns a confirmation with the IDs used. In Get Users you get one item per user found.

You can connect the result to another ActiveCampaign component, for example to create a deal with the contact’s ID, or to an agent so it can use it in its answer. The component can also be connected to an Agent as a tool, so the agent decides when to create or look up contacts. See Tool Mode.

Example

A training school wants everyone who asks for information on its website to receive its newsletter.

The website form reaches the flow with the person’s name and email.
Add ActiveCampaign Contacts with the Create Contact operation and fill Email, First Name and Phone with the form data.
Add a second ActiveCampaign Contacts with the Add to List operation. In Contact ID put the ID returned by the first one, and in List ID the ID of the newsletter list.

Good practices

Almost every operation needs the Contact ID. If you only have the email, use Get Contact first with Search By set to Email.
You get the IDs of tags and lists with ActiveCampaign Tags and ActiveCampaign Lists.

ActiveCampaign Tags: create and look up tags.
ActiveCampaign Lists: create and look up lists.
ActiveCampaign Deals: create deals linked to a contact.
ActiveCampaign Accounts: link contacts to companies.