Set up ActiveCampaign integration
The ActiveCampaign integration sends contact details collected by your AI Agent directly to your ActiveCampaign account. New leads automatically appear in your contact list, ready for follow-up or email campaigns.
In short
Heyloha connects to ActiveCampaign via your API URL and API Key. Standard fields (name, email, phone) are synchronized automatically. For address data, custom field IDs from your ActiveCampaign account are needed.
What gets synchronized?
The following standard fields are automatically synchronized with ActiveCampaign:
- First name and last name
- Email address
- Phone number
Address, zip code, city, and country can also be synchronized, but this requires custom field IDs. ActiveCampaign doesn't have standard fields for address data.
ActiveCampaign's contact sync endpoint automatically updates existing contacts when the email matches. Duplicates are prevented.
What do you need?
- An ActiveCampaign account with API access (available on all plans).
- Your API URL and API Key (found under Settings > Developer).
- An active Heyloha account with at least one AI Agent.
- Optional: custom field IDs for address, zip code, city, and country.
Find your API credentials in ActiveCampaign
Go to Settings
Log in to ActiveCampaign and go to Settings > Developer.
Copy your API URL
The API URL looks something like: https://youraccount.api-us1.com. Your URL may differ depending on your region (e.g. api-eu1.com for Europe). Copy the exact URL from your ActiveCampaign account.
Copy your API Key
The API Key is listed right below the API URL. Copy it as well.
Custom field IDs for address data (optional)
If you also want to synchronize address data, you need the numeric IDs of your custom fields:
Go to Manage Fields
In ActiveCampaign, go to Settings > Manage Fields.
Find or create the fields
Look for fields for address, zip code, city, and country. Create them if they don't exist yet.
Note the numeric IDs
Each custom field has a unique numeric ID. You can find this ID by clicking on the field and noting the number in the URL. Note the IDs for each address field.
Set up the integration in Heyloha
Open your AI Agent
Go to the Heyloha dashboard and click the AI Agent you want to connect.
Settings > Advanced > Integrations
Click 'Add integration' to create a new connection.
Choose 'ActiveCampaign' as platform
Select ActiveCampaign from the list. The form shows fields for API URL and API Key.
Enter your API credentials
Paste the API URL and API Key you copied from ActiveCampaign.
Enter custom field IDs (optional)
Each custom field has a unique numeric ID. You can find this ID by clicking on the field and noting the number in the URL. Note the IDs for each address field.
Name the integration
Choose a recognizable name, for example 'ActiveCampaign Leads'. This name is also used as an internal function name.
Select contact fields
Choose which data your AI Agent should collect. Select at least an email address.
Choose event triggers
Select when the integration should fire: when contact details are captured, when an appointment is booked, or when a goal is reached.
Describe when to use the integration
Provide an instruction for when the AI should trigger this integration.
Save and activate
Set the integration to 'Active' and click Save. Don't forget to also save the AI Agent itself.
Test the connection
After saving, you can test the connection directly using the 'Test connection' button on the integration card. A test contact is sent to ActiveCampaign.
- Green 'Connected': your API credentials are valid and ActiveCampaign accepted the test contact.
- Red error: something is wrong. Check if your API URL and API Key are correct.
Check your ActiveCampaign contacts after testing. You should see a test contact with the email address test@heyloha.ai.
Delivery log
Every dispatch attempt is recorded in the delivery log. The log shows the timestamp, event, status, and number of attempts. Heyloha retries every dispatch up to 4 times for temporary errors.
Frequently asked questions
Which ActiveCampaign plan do I need?
Any ActiveCampaign plan with API access works. The API Key is available under Settings > Developer.
Do I need to create custom fields for address data?
Only if you want to synchronize address data. For name, email, and phone, no custom fields are needed.
Can I combine ActiveCampaign with other integrations?
Yes. Each AI Agent can have multiple integrations. For example, you can send to both ActiveCampaign and HubSpot simultaneously.
Set up HubSpot integrationSet up generic webhook integration