AFI AFI

Elastic Email

Estimated reading: 3 minutes Updated August 1, 2026

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

  1. Sign in to your Elastic Email dashboard.
  2. Go to Settings → API.
  3. Create a new API Key and copy it.
  4. In WordPress, go to AFI → Settings → Elastic Email.
  5. Click Add Account, paste the API key, and give the account a name.
  6. Click Save. AFI will verify the key by calling /v2/account/load and store the publicAccountId.

Create the integration

  1. Go to AFI → Add New.
  2. Give the integration a name, for example Newsletter signup to Elastic Email.
  3. Under Trigger, pick the form plugin and the specific form.
  4. Under Action → Platform, select Elastic Email.
  5. In Task, choose Add Contact To List.
  6. Pick the saved account in the Elastic Email Account dropdown.
  7. Select a List. AFI loads your lists from the API.
  8. Map your form fields onto the Elastic Email fields listed below.
  9. Optional: open Conditional Logic to limit which submissions are sent.
  10. Click Save Integration.

Screenshot: AFI field-mapping screen with Elastic Email fields visible

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 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.

Related docs