Webform Emarsys Integration

Webform Emarsys Integration provides a Webform handler that pushes contact submissions to SAP Emarsys,
creating or updating contacts and adding them to a specified contact list.

Installation

Install as you would normally install a contributed Drupal module.
See [Installing Drupal Modules](https://www.drupal.org/docs/extending-drupal/installing-modules)
for further information.

Post-Installation

1. Navigate to **Administration > Configuration > Web services > Emarsys Api settings** (`/admin/config/services/emarsys`).
2. Enter your Emarsys **Client ID** and **Client Secret** (OAuth 2.0 credentials).
3. Save the configuration.
4. Add the **Emarsys integration** handler to any webform:
   • Edit the webform and go to **Settings > Emails / Handlers**.
   • Click **Add handler** and select **Emarsys integration**.
   • Enter the **Contact List ID** from Emarsys.
   • Configure the **Key ID** (the Emarsys field used to identify contacts, defaults to `3` which is email).
   • Configure the **Opt-in Field ID** (the Emarsys field for opt-in consent, defaults to `31`).
   • Provide a **Field Mapping** in YAML format mapping Emarsys field IDs to webform field keys.

 `yaml
     1: firstname
     2: surname
     3: email
     31: newsletter_optin
     `

Additional Requirements

- Drupal 10 or 11
- [Webform](https://www.drupal.org/project/webform) 6.x
- A SAP Emarsys account with API access (OAuth 2.0 client credentials)