Dotdigital

Dotdigital is a customer engagement and email marketing platform. With Advanced Form Integration (AFI), every WordPress form submission can create or update a contact in your Dotdigital account automatically. A typical setup: a visitor fills your Contact Form 7 or WPForms signup form, and AFI adds them to Dotdigital with the right opt-in type, ready for your campaigns.

Supported Features

• Create or update a contact by email address
• Set the contact’s opt-in type: Unknown, Single, Double, or Verified Double
• Map First Name and Last Name to the contact’s data fields
• Add the contact to a specific address book and map custom data fields. AFI Pro
• Connect multiple Dotdigital accounts and choose one per integration

What You’ll Need

• A Dotdigital account with permission to create API users
• The AFI plugin installed and active (AFI Pro for address books and custom data fields)
• A form plugin connected as the sender

Connect Dotdigital to AFI

Dotdigital uses an API user, which is separate from your normal login.

1. Log in to Dotdigital and go to Settings > Access > API users.
2. Create a new API user. It will look like ap***********@**********or.com. Set a password and save.

3. Note your account’s region. Check the address bar when logged in: it starts with r1, r2, or r3 (for example r1-app.dotdigital.com). AFI calls the matching API endpoint at https://{region}-api.dotdigital.com/v2/.
4. In WordPress, go to AFI > Settings, enable the Dotdigital tab, and open it.
5. Enter the API Username, API Password, and select the Region, then save.

You can save more than one account here. Each integration lets you pick which account to use.

How to Create the Integration

1. Go to AFI > Add New.
2. Rename the auto-filled Integration Title to something recognizable, like “Signup Form to Dotdigital”.
3. Under Trigger, select your form plugin and the specific form.
4. Under Action > Platform, select Dotdigital (or Dotdigital [PRO] if you have AFI Pro). Choose the Create or Update Contact task.
5. Select your Dotdigital Account from the dropdown.
6. Choose the Opt-In Type: Unknown, Single, Double, or Verified Double. With Double, Dotdigital handles the confirmation flow according to your account settings.
7. Map the fields, then click Save Integration.

Field Mapping

Field	Description
Email	Required. The contact’s email address; used to create or match the contact
First Name	Mapped to the FIRSTNAME data field
Last Name	Mapped to the LASTNAME data field
Address Book	AFI Pro. Pick the address book the contact should be added to
Custom data fields	AFI Pro. Your account’s data fields load automatically for mapping

If a contact with the same email already exists, AFI updates it instead of creating a duplicate.

Troubleshooting

Authentication errors in the log

Double-check you are using the API user (ap***********@**********or.com), not your normal Dotdigital login, and that the region matches your account. A wrong region produces connection or authorization errors.

Contacts are not appearing

Go to AFI > Log and open the most recent entry. It shows the payload AFI sent and Dotdigital’s response. A missing or invalid email is the most common cause, since Email is the required field.

The contact was created but has no name

Confirm First Name and Last Name are mapped in the integration. Empty mapped values are skipped rather than sent as blanks.

Related Docs

• Your First Integration
• Smart Tags & Field Mapping
• Log
• Integration not firing