ActiveCampaign Integration

This guide walks you through connecting Fluentos with ActiveCampaign so you can:

• Sync leads - every lead captured by your Fluentos campaigns is automatically sent to ActiveCampaign as a contact.
• Identify returning visitors - recognise contacts arriving from ActiveCampaign emails and automatically store their name and email in Fluentos for personalisation.
• Enrich profiles - enrich contact data with new information collected through quizzes, games, or simple input fields.
• Target by Tags - personalise engagement based on the ActiveCampaign tags assigned to a contact.

Fluentos is an official ActiveCampaign Partner App - view the listing on the ActiveCampaign Marketplace.

You will need:

• Access to ActiveCampaign with admin permissions
• Fluentos account with an active website

---

1. Find Your API Credentials

1. Log in to your ActiveCampaign account.
2. Click Settings (top-right corner).
3. In the left menu, select Developer.
4. Copy the URL and Key from the API Access panel - you will paste them into Fluentos in the next step.

2. Add ActiveCampaign to Fluentos

1. Open the Fluentos Dashboard at app.fluentos.com.
2. On the left side, click Integrations.
3. Click the Add New Integration button.
4. Fill in the fields:
   • Integration Name - give it a recognisable name, e.g. ActiveCampaign
   • Select Integration - choose ActiveCampaign
   • Enabled - toggle it on
   • API URL - paste the URL you copied from ActiveCampaign
   • API Key - paste the Key you copied from ActiveCampaign
5. Under Notification Recipients, add one or more email addresses that should receive alerts if the integration encounters errors.

Validate Your Connection

Click the Validate Connection button. You should see “Integration Connection Verified” at the bottom of the screen.

6. Click Save to finish.

Validation Fails?

Double-check that your API URL starts with https:// and does not have a trailing slash. Also verify the API key was copied in full - ActiveCampaign keys are long.

---

3. Sending Leads to ActiveCampaign

When you attach the ActiveCampaign integration to a Fluentos campaign, every form submission is sent to ActiveCampaign as a contact.

Choosing a Subscriber List

In the campaign’s integration settings you will see a Subscriber List dropdown. This controls which ActiveCampaign list the contact is subscribed to:

• Select a list - the contact is created and subscribed to that list. Use this for opt-in flows, newsletter signups, or any scenario where you want the contact on a specific list right away.
• Leave it empty - the contact is created in ActiveCampaign without being added to any list. This is useful when you only want to collect or enrich contact data and manage list subscriptions separately inside ActiveCampaign (e.g. through automations).

Email Is Always Required

ActiveCampaign requires an email address for every contact. Make sure the email field is always mapped in your campaign integration settings. If the visitor was already identified through audience targeting, Fluentos automatically uses the email from their profile - no email field is needed in the form.

Double Opt-In (Using an “On Hold” List)

If you need Double Opt-In, use a dedicated on-hold list. Fluentos sends new contacts to that list, and an ActiveCampaign automation moves them to your final marketing list after they confirm.

Set it up

1. Create two lists in ActiveCampaign:

   • A holding list, e.g. Fluentos – On Hold
   • Your main list, e.g. Master Contact List

2. In Fluentos, set the Subscriber List to Fluentos – On Hold.

3. Create an automation in ActiveCampaign:

   • Trigger: Subscribes to list -> Fluentos – On Hold (runs once)
   • Action: Send a confirmation email with a button (e.g. “Confirm my subscription”)
   • Button link action: Subscribe to list -> Master Contact List (and optionally unsubscribe from Fluentos – On Hold)

4. Important: In the email designer, make sure link tracking is turned on. Without it, ActiveCampaign cannot detect the button click and the contact will not be moved.

Result: new contacts land on the holding list, receive a confirmation email, and only move to your real list once they click confirm.

Single Opt-In

If you do not need Double Opt-In, simply set the Subscriber List to your main list (e.g. Master Contact List). Contacts will be active on that list immediately after submitting via Fluentos.

---

4. Audience Targeting

Audience targeting lets you identify visitors arriving from ActiveCampaign emails and personalise their experience in two ways:

• Show relevant campaigns - use Display Rules to show or hide campaigns based on the ActiveCampaign tags assigned to a contact. Tags are the recommended way to segment contacts in ActiveCampaign and allow for very dynamic personalisation through automations.
• Greet visitors by name - optionally store the visitor’s first name and use it in your campaign content.

Enable Audience Targeting

In your ActiveCampaign integration settings, toggle on Enable audience targeting. Two additional fields appear:

• Link parameter - the URL parameter Fluentos reads from the landing page URL (default: _accm).
• Cookie name - the cookie Fluentos uses to remember the visitor on return visits (default: _accm_id).

Add the Contact’s Email to Your Email Links

ActiveCampaign does not automatically add contact details to links. You need to append them manually using a personalization tag.

When editing a link in your ActiveCampaign email or automation, add the link parameter with %EMAIL%. For example, change:

https://yoursite.com/landing-page

to:

https://yoursite.com/landing-page?_accm=%EMAIL%

When the email is sent, ActiveCampaign replaces %EMAIL% with the contact’s actual email address. The resulting link looks like:

https://yoursite.com/landing-page?_accm=john@example.com

Add the Parameter to Every Link

Append ?_accm=%EMAIL% (or your custom parameter name) to every link in your ActiveCampaign emails that points to a page where Fluentos is loaded. Without the parameter, Fluentos cannot identify the visitor.

What Is %EMAIL%?

%EMAIL% is an ActiveCampaign personalization tag. When an email is sent, ActiveCampaign replaces it with the recipient’s email address. It is the same value ActiveCampaign uses to uniquely identify a contact.

How It Works

1. A contact clicks a link in an ActiveCampaign email. The link includes ?_accm=%EMAIL%, which ActiveCampaign replaces with their email address.
2. Fluentos reads the email from the URL and saves it in a cookie so the visitor is recognised on future visits.
3. On each page view, Fluentos looks up the contact in ActiveCampaign, retrieves their tags and profile data, and uses this to evaluate Display Rules and populate the DataHub.

What Happens When a Visitor Is Identified

Once a visitor is identified through the email link, Fluentos automatically fetches their profile from ActiveCampaign and stores it in the DataHub:

Field	DataHub Key	Description
Email	{{dataHub:activecampaign-email}}	Always stored. Required to correctly sync any new data submitted by the visitor back to the right contact in ActiveCampaign.
First Name	{{dataHub:activecampaign-firstName}}	Optional. Toggle on in the integration settings to store the contact’s first name so you can greet them by name in your campaign content.

The visitor does not need to fill in their email again - Fluentos already knows who they are. When they submit a form, Fluentos automatically uses the stored email to link the submission to the correct contact. This lets you skip the email field and focus on collecting new information like preferences, quiz answers, or feedback.

To use a stored value in your campaign content, reference its DataHub key. For example, {{dataHub:activecampaign-firstName:Name}} displays the visitor’s first name, with Name as a fallback shown in the designer and when no value is available. Learn more in the DataHub documentation.

DataHub in Display Rules

You can also use DataHub values in campaign Display Rules with the DataHub trigger. For example, set the key to activecampaign-firstName with match type Has any value to show a campaign only to visitors whose name is known.

Using Audience Targeting in Campaign Display Rules

Once audience targeting is enabled, you can control which campaigns are shown based on tag assignment:

1. Open your campaign in the Fluentos editor.
2. Go to the Publish tab -> Display Rules.
3. Under Audience Targeting, toggle on Target by audience.
4. Select your ActiveCampaign integration as the Data Source.
5. Set the Rule - e.g. In audience or Not in audience.
6. Select a Tag from the dropdown - tags are fetched directly from your ActiveCampaign account.

The campaign will only be shown (or hidden) for visitors who have the selected tag.

Why Tags?

Tags are the recommended way to segment contacts in ActiveCampaign. Unlike lists, tags can be added and removed dynamically through automations - for example, tagging a contact as vip when they reach a spending threshold, or churned when they haven’t purchased in 90 days. This makes audience targeting highly dynamic without manual list management.

Use Cases

• Show a special offer only to contacts tagged vip-customer
• Hide a newsletter signup popup for contacts tagged newsletter-subscriber
• Display a win-back campaign only to contacts tagged churned

---

5. Testing Your Setup

Test Lead Sync

1. Create a test campaign with at least an email input field.
2. Publish it and submit a test entry with your own email address.
3. In ActiveCampaign, search for the email you submitted.
4. Verify the contact was created (and assigned to the correct list, if you selected one).

Use a Real Email

ActiveCampaign may reject obviously fake email addresses. Use a real email for testing.

Test Audience Targeting

1. Send yourself a test email from ActiveCampaign with ?_accm=%EMAIL% appended to a link.
2. Click the link to land on your website.
3. Open the browser’s Developer Tools -> Application tab and check that the cookie (default: _accm_id) was created.
4. Navigate to a page with a campaign that targets an ActiveCampaign tag. Confirm the campaign shows or hides as expected.

Use an Incognito Window

Testing in a private/incognito window ensures you start without existing cookies. Make sure to click the email link from within the incognito window.

---

6. Troubleshooting

Integration validation fails

• Verify the API URL starts with https:// and has no trailing slash
• Make sure the API key was copied in full - ActiveCampaign keys are long
• Confirm the API key has the correct permissions in ActiveCampaign

Contacts not appearing in ActiveCampaign

• Check that email is mapped in your campaign integration - it is required by ActiveCampaign
• Look at the integration status in Fluentos for any error indicators

Automatic Retries

If ActiveCampaign is temporarily unavailable, Fluentos automatically retries. You will be notified by email if all retries are exhausted.

Audience targeting does not work

• Verify Enable audience targeting is turned on in the integration
• Confirm your email links include ?_accm=%EMAIL% (or your custom parameter)
• Check that the Link parameter in Fluentos matches the parameter in your email links exactly
• Open Developer Tools -> Application tab and verify the cookie is present
• Make sure Fluentos is loaded on the landing page

How to check the audience response

Open Developer Tools -> Network tab and filter by fluentos. When a visitor has a valid cookie and a campaign uses audience targeting, you will see an audience request. The response tells you what happened:

• {"audiences": [1, 2]} - the visitor was identified and has these tag ids
• {"audiences": []} - the visitor was identified but has no tags assigned
• {"audiences": null} - the visitor could not be identified - check the cookie and link parameter

Campaign does not show for a visitor who should have the tag

• Check the audience response (see above) to confirm the expected tag id appears
• Verify the Data Source in the campaign’s Display Rules points to the correct ActiveCampaign integration
• Clear cookies and click the email link again in an incognito window to rule out stale values
• Confirm the tag is assigned to the contact in ActiveCampaign - check under the contact’s profile in ActiveCampaign