Connect ActiveCampaign with Framer Forms
Capture leads from your Framer forms and automatically add them to your ActiveCampaign contacts using the Forms Plugin.
Step 1 - Get Your ActiveCampaign API Key and Account URL
Before connecting ActiveCampaign to your form, get your API key and account URL from your ActiveCampaign account. These allow the Forms Plugin to securely send form submissions to ActiveCampaign.
- Login to your ActiveCampaign account
- Navigate to Settings → Developer
- Copy your API Key and Account URL
Keep your API key in a secure password manager. Never share it publicly or commit it to a code repository.
Select your form in the Framer canvas and insert the ActiveCampaign component.
The component connects your form to ActiveCampaign and automatically detects the form fields in your form layout.
After inserting the ActiveCampaign component, configure the API settings in the component properties panel.
- Select the ActiveCampaign Integration component in your form
- Open the properties panel on the right side
- Paste your ActiveCampaign API Key
- Enter your Account URL
Required Fields
- API Key - Paste the API key from your ActiveCampaign account.
- Account URL - Enter your ActiveCampaign account URL (e.g.,
https://youraccountname.activehosted.com).
The Lists field lets you automatically subscribe new contacts to one or more ActiveCampaign lists when the form is submitted. This is useful for organizing contacts by channel (Email or SMS), campaign source, or audience segment.
- Open the API Settings modal on the ActiveCampaign component
- Scroll to the Lists field
- Click the field and enter one or more List IDs
- Save the component
How to Find Your List ID
Each ActiveCampaign list has a numeric ID that you can grab from the URL.
- Login to your ActiveCampaign account
- Open Contacts → Lists
- Click the list you want to subscribe contacts to (or open its contacts view)
- Look at the URL in your browser. The list ID will appear in the URL as
/list/{id} or as the listid={id} query parameter (for example, ?listid=2). The number is the List ID.
You can also see all your lists and their channels (Email or SMS) on the Contacts → Lists page:
You can find or create lists at Contacts → Lists → Add a list in the ActiveCampaign sidebar. Each list has its own marketing channel (Email or SMS) which determines how the contact is subscribed.
SMS-Channel Lists
If a list is set up as an SMS marketing channel, ActiveCampaign requires a phone number for the subscription. The form must include a phone field that is mapped in Step 5 - Configure Field Mapping below. Without the phone mapping, ActiveCampaign will reject the subscription and the contact will not be added to the SMS list.
Email-Channel Lists
Email lists subscribe contacts using their email address only. As long as your form has an email field mapped, the contact will be added without any extra setup.
Map your form fields to ActiveCampaign contact properties.
The component automatically detects your form field names. You simply connect each field to the correct ActiveCampaign property.
Example Mapping
| Form Field | ActiveCampaign Property |
|---|
| email | email |
| firstname | firstName |
| lastname | lastName |
| phone | phone |
If you’re subscribing contacts to an SMS list (see Step 4), make sure the phone mapping is present. Otherwise the subscription request will be rejected by ActiveCampaign.
Step 6 - Result
When a user submits the form, their details will automatically be added as a contact in ActiveCampaign and subscribed to any List IDs you configured. You can verify new contacts in your Contacts → Lists view by opening the relevant list.
Next Steps
