Campaigner Integration

3 min readUpdated June 20, 2026

Campaigner is an email marketing platform focused on segmentation and automated campaigns. WP Smart Consent integrates with Campaigner via the Contacts API, forwarding opted-in contacts to your account in real time using a single upsert call that handles both new contacts and updates to existing ones.

What You’ll Need#

A Campaigner API key. To find it, log into your Campaigner account, go to Settings → API and copy your key.

Connection Tab#

Paste your API key into the Connection tab and save. WP Smart Consent will connect to your Campaigner account and populate a list dropdown with your available contact lists. Select one or more lists to add opted-in contacts to.

Unlike some platforms, Campaigner handles list membership and segmentation as a separate concern from the contact record itself — the contact is created or updated first, then list assignments are applied.

A screenshot of the "Campaigner" email marketing integration settings. Tabs include Connection, Field mapping, Custom fields, and Options. The "Enabled" toggle is off. An "API key" field is empty. A green "Save Campaigner" button is at the bottom.

Field Mapping Tab#

Email, first name, and last name are always sent to Campaigner regardless of field mapping configuration. The field mapping tab lets you forward additional contact data to Campaigner custom fields.

Campaigner custom fields are referenced by their field name as configured in your Campaigner account. In the field mapping table, set the destination key to the exact field name — for example Phone, Company, or Country. Custom fields must already exist in your Campaigner account before mapping them here. Go to Contacts → Custom Fields in Campaigner to view and create fields.

The mapped values are sent in the CustomFields array in the API call, each as a {FieldName, Value} pair.

Available WPSC source fields for mapping: phone, company, country, order total, source URL.

A settings page titled "Campaigner" shows field mapping options for email marketing. Four rows map fields like email, first name, and last name to destination keys. Extra fields (Phone, Company, Country) can be added or removed. A "Save Campaigner" button is at the bottom.

Options Tab#

Update existing — when enabled (the default), if a contact with the same email already exists in Campaigner their record will be updated with new field values and list memberships. When disabled, existing contacts are skipped entirely.

Send on unchecked — when enabled, contacts are forwarded to Campaigner even when the opt-in checkbox was not ticked. Use this if you manage consent at the Campaigner list or segment level rather than at the checkbox level.

How the API Call Works#

WP Smart Consent sends a POST to Campaigner’s Contacts/Upsert endpoint with the following structure:

json

{
  "Email": "jane@example.com",
  "FirstName": "Jane",
  "LastName": "Smith",
  "CustomFields": [
    { "FieldName": "Phone", "Value": "+1 555 000 0000" },
    { "FieldName": "Company", "Value": "Acme Inc" }
  ],
  "Lists": [12, 34]
}

The Lists array contains the numeric IDs of your selected lists. CustomFields contains any additional fields configured in the field mapping tab.

Troubleshooting#

Contact not appearing in Campaigner — verify the API key is correct and has not expired. Campaigner API keys do not auto-renew and may need to be regenerated periodically from the Settings panel.

Custom field values not saving — confirm the FieldName in the field mapping table exactly matches the field name in your Campaigner account, including capitalisation. Campaigner will silently ignore fields it does not recognise.

Contact not added to list — confirm the selected list still exists in Campaigner. If a list was deleted or renamed after the integration was saved, re-open the Connection tab and re-select your lists.