Framer EmailOctopus Integration: Contacts to Lists
Email Marketing • Native Edge SyncAdd or update contacts in an EmailOctopus list, with fields and tags. Connect your native Framer forms to EmailOctopus in 30 seconds with zero client-side API key leaks.
Framer to EmailOctopus: setup guide
FramerSend adds every Framer form submission to an EmailOctopus list, or updates the contact when the email is already there, through EmailOctopus API v2. First and last name go to the built-in fields, other answers go to the list's custom fields with the same tag, and your tags are added.
What gets created: A contact in your list, created or updated with PUT /lists/{list_id}/contacts, with status subscribed (or pending for double opt-in).
How your form fields map to EmailOctopus
| Framer form field | EmailOctopus |
|---|---|
| email_addressRequired. | |
| first_name / firstName, or name | FirstName |
| last_name / lastName | LastName |
| tags | TagsComma-separated; added to the tags set on the connection. Other tags on the contact are kept. |
| Any other field, e.g. Company | Field tag CompanyThe field must exist on the list with that tag. Fields EmailOctopus rejects are left out and the contact is still saved. |
Step by step
- 1
Create an API key
In EmailOctopus, open Integrations & API and create an API key.
- 2
Copy the List ID
Open the list, then Settings, and copy the List ID.
- 3
Connect and test
In FramerSend, open Connections, add this connector, paste the values and click Test. Save it, then attach it to your form. The Test button reads the list with the key, so it checks both without adding a contact.
- 4
Send from Framer
In Framer, select the form, open Form → Send to → Add… → Webhook, paste your FramerSend webhook URL, and publish the site.
Common errors and fixes
EmailOctopus: Email is required
Add an email input to the Framer form.
EmailOctopus (HTTP 401): …
Create a new API key in EmailOctopus → Integrations & API.
EmailOctopus (HTTP 404): …
Cause: The List ID is wrong or the list was deleted.
Fix: Copy the List ID again from the list's Settings.
EmailOctopus (HTTP 422): …
Cause: EmailOctopus rejected the contact, for example an invalid email address.
Fix: Check the message; fields the list doesn't have are dropped automatically.
How it works in 3 simple steps
Zero code or third-party plugins required
Connect
Authenticate EmailOctopus credentials in the FramerSend dashboard. We encrypt and store them securely.
Map Fields
Map your Framer form fields to EmailOctopus properties using our visual dropdown UI.
Go Live
Paste your webhook URL into your Framer form under Send to → Webhook and publish. Submissions flow automatically.
Get EmailOctopus Integration
Every plan includes EmailOctopus and 100+ other connectors. Pay monthly, yearly, or once. Try it free for 14 days, no card needed.
1 Site
For one Framer site
- EmailOctopus and every other connector (100+)
- 1 Framer site
- Unlimited submissions & file uploads
- API keys stay on our server, never in your site
- Cancel anytime
5 Sites
PopularFor freelancers and small studios
- EmailOctopus and every other connector (100+)
- 5 Framer sites
- Unlimited submissions & file uploads
- API keys stay on our server, never in your site
- Cancel anytime
Unlimited Sites
For agencies with many client sites
- EmailOctopus and every other connector (100+)
- Unlimited Framer sites
- Unlimited submissions & file uploads
- API keys stay on our server, never in your site
- Cancel anytime
14-day free trial, no card needed. Unlimited submissions while you test.
Start freeWhy teams use FramerSend for EmailOctopus
Encrypted API vault, real-time delivery, and unlimited submissions
Lead Generation
Capture leads from your Framer site and auto-add them to targeted email campaigns.
Newsletter Signups
Convert visitors into subscribers with a seamless form-to-list flow.
Customer Onboarding
Automatically enroll new customers into welcome sequences.
Frequently asked questions
Does it support double opt-in?
Yes. Set Status for contacts to pending and EmailOctopus sends its confirmation email.
What happens when the contact already exists?
It is updated with the new answers and tags. Because the status is set on every submission, a contact who unsubscribed and fills in the form again is subscribed again (or pending).
Which API version is used?
EmailOctopus API v2 (api.emailoctopus.com).
How do I connect Framer to EmailOctopus?
Sign up for a FramerSend account (or log in). Go to Connections → Add Connection → EmailOctopus and add your credentials. They are stored server-side and never exposed in your Framer site, which only gets a public form URL.
Are my API keys safe?
Yes, all API credentials are encrypted at rest. The client-side code in Framer only exposes a public Form ID, keeping your private keys entirely secure.
Are there monthly submission limits?
No. FramerSend provides unlimited form submissions across all license tiers so your live website forms never get blocked during high-traffic spikes.