AFI
Benchmark
Benchmark (Benchmark Email) is an email marketing platform. AFI adds contacts to Benchmark lists via the Benchmark Email Client API (clientapi.benchmarkemail.com), authenticating with an AuthToken header.
What you’ll need
- An active Benchmark Email account.
- An API Key from Benchmark.
- The Advanced Form Integration plugin installed and activated.
Save your Benchmark API key
- Log in to your Benchmark Email account.
- Go to Profile → Integrations → API Key and copy the key.
- In WordPress, go to AFI → Settings → Benchmark.
- Paste the API Key and click Save.
Create the integration
- Go to AFI → Add New.
- Give the integration a name.
- Under Trigger, pick your form plugin and form.
- Under Action → Platform, select Benchmark.
- In Task, choose Add Contact.
- Select the saved Benchmark account and a contact list.
- Map form fields to Benchmark contact fields.
- Click Save Integration.
Tasks supported
Add Contact (Free + Pro)
Adds a contact to the selected Benchmark list via POST /Contact/{listId}/ContactDetails. AFI first checks if the contact already exists by email; if so, it updates the existing contact instead of creating a duplicate. The EmailPerm field is set to 1 (opted in) by default.
| Field | Field key | Required | Notes |
|---|---|---|---|
email |
Yes | ||
| First Name | firstName |
No | |
| Middle Name | middleName |
No | |
| Last Name | lastName |
No |
The free version supports email, first name, middle name, and last name only. Benchmark [PRO] adds custom field mapping, Upsert Contact, and Delete Contact tasks.
Pro features
The Pro integration (Benchmark [PRO]) extends the free version with custom fields, upsert, and delete capabilities.
| Feature | Free | Pro |
|---|---|---|
| Add Contact | ✅ | ✅ |
| Standard fields (email, name) | ✅ | ✅ |
| Custom fields | No | ✅ |
| Upsert Contact | No | ✅ |
| Delete Contact | No | ✅ |
Troubleshooting
Contact not created
- Check AFI → Log for errors.
- Verify the API Key is correct.
- Ensure the email field is mapped and contains a valid email.
429 Too Many Requests
Benchmark caps usage at 500 calls per 2 minutes. AFI automatically retries once after a short back-off when a 429 is received.