Elastic Email
Elastic Email is an email marketing and transactional email platform. Advanced Form Integration adds contacts to your Elastic Email lists from WordPress form submissions, so every newsletter signup or lead capture grows your audience automatically.
What you’ll need
- An active Elastic Email account.
- An Elastic Email API Key (see below).
- The Advanced Form Integration plugin installed and activated.
Get your Elastic Email API key
- Sign in to your Elastic Email dashboard.
- Go to Settings → API.
- Create a new API Key and copy it.
- In WordPress, go to AFI → Settings → Elastic Email.
- Click Add Account, paste the API key, and give the account a name.
- Click Save. AFI will verify the key by calling
/v2/account/loadand store thepublicAccountId.
Create the integration
- Go to AFI → Add New.
- Give the integration a name, for example
Newsletter signup to Elastic Email. - Under Trigger, pick the form plugin and the specific form.
- Under Action → Platform, select Elastic Email.
- In Task, choose Add Contact To List.
- Pick the saved account in the Elastic Email Account dropdown.
- Select a List. AFI loads your lists from the API.
- Map your form fields onto the Elastic Email fields listed below.
- Optional: open Conditional Logic to limit which submissions are sent.
- Click Save Integration.

Tasks supported
Add Contact To List
Adds a contact to the selected list via POST /v2/contact/add. The request includes the public list ID, the public account ID, and the contact’s email and name.
| Field | Field key | Required | Notes |
|---|---|---|---|
email |
Yes | Subscriber email address | |
| First Name | firstName |
No | |
| Last Name | lastName |
No |
Pro features
The Pro integration extends the free version with custom fields and two additional tasks. Pro uses the same Elastic Email API key connection.
Custom fields
Pro supports custom fields using the pipe-separated format field_name=value|field_name2=value2. Each entry is sent to Elastic Email with a field_ prefix.
Additional Pro tasks
- Unsubscribe Contact: changes the contact’s status to Unsubscribed via
POST /v2/contact/changestatus. - Delete Contact: hard-deletes the contact via
POST /v2/contact/quickdelete.
Feature comparison
| Feature | Free | Pro |
|---|---|---|
| Add contact to list | ✅ | ✅ |
| Email + name fields | ✅ | ✅ |
| Custom fields | No | ✅ |
| Unsubscribe contact | No | ✅ |
| Delete contact | No | ✅ |
Conditional logic example
Only add contacts to your “Premium Newsletter” list when the form’s subscription_type field is “premium”. Free subscribers go to a standard list via a separate integration.
Troubleshooting
Nothing arrives in Elastic Email
Open AFI → Log and find the most recent entry. AFI stores the request URL, body, and raw response from Elastic Email.
API key rejected
Verify the API key in Settings → API in your Elastic Email dashboard. If regenerated, update it in AFI → Settings → Elastic Email.
Rate limited (HTTP 429)
AFI automatically retries once on HTTP 429, honoring the Retry-After header with a 2-second default.