---
title: Configuration
slug: campaign/docs/configuration
docTags: 
createdAt: 2026-07-20T15:45:10.133Z
---

:::hint{type="info"}
**Note**

This topic is for administrators and developers with administration access rights in Microsoft Dynamics.
:::

This topic describes how to configure the Microsoft Dynamics CRM integration, if you are using this with Optimizely Campaign.

The configuration includes these steps:

1. Enter [SOAP API user data](docId\:amcyrSqPEVelSryjVZUFT).
2. Enter [client IDs](docId\:amcyrSqPEVelSryjVZUFT).
3. Start [response data workflows](docId\:amcyrSqPEVelSryjVZUFT).
4. Assign Optimizely Campaign [test lists](docId\:amcyrSqPEVelSryjVZUFT)
5. Create [advertising consents ](docId\:amcyrSqPEVelSryjVZUFT)and link to client.

To transfer fields not included in the [standard configuration](docId\:amcyrSqPEVelSryjVZUFT), you must also configure the [additional fields](docId\:amcyrSqPEVelSryjVZUFT) for your Optimizely Campaign recipient list.

## [configuration.mdx](docId\:amcyrSqPEVelSryjVZUFT)Entering SOAP API user data

Communication and data exchange between Microsoft Dynamics and Optimizely Campaign uses the SOAP API. To link CRM with Optimizely Campaign via the interface, you must enter your SOAP API user data in Microsoft Dynamics.

:::hint{type="info"}
**Note**

If you do not have a SOAP API user account, contact [customer support](docId\:ZWe1T3UPz3JW6_4mc76qV).
:::

1. Log in to Microsoft Dynamics CRM with administrator rights.
2. Open Microsoft Dynamics CRM and select **Settings** > **API data**.

   :::hint{type="info"}
   **Tip**

   The integration adds a new **Episerver Campaign** section to your CRM settings.
   :::

   ![Image: API data](https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/YnZHGQQAvPvjxNOF_0W6y-20260720-145418.png "Image: API data")
3. Click **New**.
4. For **API User**, enter your SOAP API user name.

   ![Image: API User](https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/FehgTPsAQmX_CpvKZESwT-20260720-145418.png "Image: API User")
5. For **API Password**, enter your SOAP API password.

   ![Image: API password](https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/DLs6ycQ2nU1fx1Y0ExHlU-20260720-145418.png "Image: API password")
6. Click **Save & Close**.

## [configuration.mdx](docId\:amcyrSqPEVelSryjVZUFT)Entering client IDs

To run campaigns, specify which Optimizely Campaign client you want to use in CRM for sending.

1. Open Microsoft Dynamics CRM and select **Settings** > **Clients**.

   ![Image: Clients](https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/-44yDvin5XT9dx-Q892Zu-20260720-145418.png "Image: Clients")
2. Click **New**.
3. For **Client ID**, enter the ID of the client to use for sending campaigns.

   ![Image: Client ID](https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/_eg8BHxkj3kxsaYFftbW7-20260720-145418.png "Image: Client ID")

   :::hint{type="info"}
   **Tip**

   You can find the client ID in the Optimizely Campaign [menu](docId\:PmNPgvNucBrAG5Rw8f41f) under **API Overview** > **REST API**.
   :::
4. For **Description**, enter the name of the client.

   ![Image: Description](https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/42sBIPqEKnOQZwDGy0elj-20260720-145418.png "Image: Description")

   :::hint{type="info"}
   **Tip**

   The name of client is displayed at top right in the menu bar in Optimizely Campaign.
   :::
5. For **API User**, select your SOAP API user. See [Enter SOAP API user data](docId\:amcyrSqPEVelSryjVZUFT).

   ![Image: API User](https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/Qfvzb1cDHkdt0rIx5-XbJ-20260720-145418.png "Image: API User")
6. Click **Save & Close**. To add more clients, repeat the steps for each additional client.

## [configuration.mdx](docId\:amcyrSqPEVelSryjVZUFT)Starting response data workflows

To feed campaign response data from contacts and leads in Optimizely Campaign into CRM, start the response data workflows for each individual client. The workflows query and import recipient response data in 60-minute intervals.

These workflows are available for each response type:

| Workflow                     | Response type                                           |
| ---------------------------- | ------------------------------------------------------- |
| Optimizely: Get opens        | Mailing opened                                          |
| Optimizely: Get clicks       | Link clicked in the mailing                             |
| Optimizely: Get responses    | Direct reply to the mailing                             |
| Optimizely: Get unsubscribes | Newsletter unsubscribes                                 |
| Optimizely: Get outbounces   | Outbounce (the recipient has exceeded the bounce limit) |

Do the following to start workflows:

1. Select the clients to start workflows for. If the list of clients does not open, go to **Settings** > **Clients**.

   ![Image: Clients](https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/4UgVWul1soUhX66almJoC-20260720-145418.png "Image: Clients")
2. Click **Run Workflow**.

   ![Image: Run Workflow](https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/DQPC4mybuMRuB_trNus3P-20260720-145418.png "Image: Run Workflow")
3. Select a workflow and click **Add**.

   ![Image: Add workflow](https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/fpwUEftIgIGF00uvdgMu4-20260720-145418.png "Image: Add workflow")
4. Click **OK** to confirm.
5. Repeat steps 1–4 for each workflow.

You can see workflow activity in the **Information** view for the client. Click the corresponding client ID in the list to open it. Under access data, you can see when the workflow was last run, and timestamp for the most recently imported data.

## [configuration.mdx](docId\:amcyrSqPEVelSryjVZUFT)Assigning Optimizely Campaign test lists

To [check](docId\:yWEhQH2UOhqLyJ3ch08Vj) the campaign mailings before dispatch, you can send them to an Optimizely Campaign test list. To do this, you must assign the Optimizely Campaign test list in Microsoft Dynamics CRM. Do the following:

1. Go to **Settings** > **Episerver Campaign** > **Episerver Campaign** > **Clients**.
2. Click **Client**.
3. Click **Add Testlist record**.

   ![Image: Add Testlist record](https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/4ajIRrb7G5xDINCbz61NE-20260720-145419.png "Image: Add Testlist record")
4. Enter a name for the test list.

   ![Image: Test list name](https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/QyVZ_QzP7igfkLfK39kJ6-20260720-145419.png "Image: Test list name")
5. Enter the recipient list ID of the test list. To see the recipient list ID, open the Optimizely Campaign[ menu](docId\:PmNPgvNucBrAG5Rw8f41f) and select **Administration** > **API overview** > **Recipient lists**.

   :::hint{type="info"}
   **Tip**

   If you are missing the **ID** column, click the down arrow **v** in the upper right corner of the table header and activate the **ID** check box.
   :::

   ![Image: Test list ID](https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/awFY8Hsmu33A6ImevXtwp-20260720-145419.png "Image: Test list ID")
6. Click **Save** and close the window.

   ![Image: Save](https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/4mFcf7D4O-EQMf8b8fXrF-20260720-145419.png "Image: Save")

:::hint{type="info"}
**Tip**

To assign more test lists, repeat the steps for each additional test list.
:::

## [configuration.mdx](docId\:amcyrSqPEVelSryjVZUFT)Creating consents and linking to client

To send mailings, you need advertising consent from contacts and leads. The consent protects recipients from unwanted omnichannel marketing. See also [Opt-in](docId:1E5S4MmWzP3r8i1F0zA9e). The integration checks two fields in Microsoft Dynamics for each contact and lead, to see if consent is given or withdrawn, and will not transfer recipients without consent.

Furthermore, you record the [bounce status](docId\:VMzatoDq75F2ROgHPxj2h) for the contact, lead or account, which makes a statement about the functionality of the advertising agreement.

Perform the following steps:

1. [Creating a bounce status field](docId\:amcyrSqPEVelSryjVZUFT)
2. [Adding the bounce status field to a form](docId\:amcyrSqPEVelSryjVZUFT)
3. [Creating advertising consent and associating the bounce status field](docId\:amcyrSqPEVelSryjVZUFT)

### [configuration.mdx](docId\:amcyrSqPEVelSryjVZUFT)Creating a bounce status field

1. Log in to Microsoft Dynamics CRM with administrator rights.
2. Go to **Settings** > **Customizations**.

   ![Image: Customizations](https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/Awgu3haYt8BM8CUClx1zE-20260720-145419.png "Image: Customizations")
3. Click **Customize the System**.

   ![Image: Customize the System](https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/dOy9pmFjd0b0CXGISMLEe-20260720-145419.png "Image: Customize the System")
4. Use the side navigation to go to **Components** > **Entities** > **Contact** or **Lead** or **Account** > **Fields**.

   ![Image: Fields](https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/kiXwBROXVXIWJ630-gN_i-20260720-145419.png "Image: Fields")
5. Click **New**.

   ![Image: New field](https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/OE9QdOz-xByNrVS7RciHA-20260720-145419.png "Image: New field")
6. Specify the following fields:

   ![](https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/u-Taaown6yTaSRrq1z8Ka-20260720-145419.png)

   - **Display Name**. Enter an intuitive name, for example *EpiOutbounce E-Mail*.
   - **Name**. Click into any other field. The entry is automatically copied to the **Name** box (without spaces or special characters), with the prefix *new\_* added. Change the automatically created entry in the **Name** box, such as changing it to *new\_epioutbounce eMail*. Do not use spaces or special characters. Note the entry in the **Name** box, you will need this later for the advertising consent.

   ![](https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/aEgx6hq6VhgitcNM_iTq_-20260720-145419.png)

   - **Field Requirement**: Select **Optional**.
   - **Searchable**: Select **Yes**.
   - **Field Security**. Select **Disable**.
   - **Auditing**. Select **Enable**.
   - **Description**. Optional: Enter a field description.
   - **Data Type**. Select **Two Options**. A field containing the options **No** and **Yes** appears.

   ![](https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/p6OwZODUwS_F8vv-mPghL-20260720-145419.png)

   - **Field Type**. Select **Simple**.
7.  Click **Save and Close**.

   ![](https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/Lb2ZplKoT3Rwk2FIxRYP2-20260720-145419.png)

### [configuration.mdx](docId\:amcyrSqPEVelSryjVZUFT)Adding the bounce status field to a form

1. Use the side navigation to go to **Components** > **Entities** > **Contact** or **Lead** or **Account** > **Forms**.

   ![Image: Forms](https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/QiM9clvSXiiHEdOBOFNdg-20260720-145419.png "Image: Forms")
2. Click the form for which you want to add the advertising consent presence field.

   ![Image: Select form](https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/Eu6KuuBBrGROFzTwNKKQX-20260720-145419.png "Image: Select form")
3. Click the area, for example **Marketing**, where the field for presence of advertising consent should appear. When the area is selected, the surrounding dashed line becomes solid.

   ![Image: Select location of advertising consent](https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/Xlg04gPOGY6UygiI4Ju1P-20260720-145419.png "Image: Select location of advertising consent")
4. On the right, open the **Field Explorer** and browse for the field you created for the advertising consent presence.

   :::hint{type="info"}
   **Tip**

   You can filter the number of fields shown.
   :::

   ![](https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/asrWvGMXeMAP0BEzvpL4k-20260720-145419.png)
5. Double-click the advertising consent field to add it to the selected area.

   ![Image: Select advertising consent](https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/7tA1aEJ9Cw_UApUMVBhOs-20260720-145419.png "Image: Select advertising consent")
6. Click **Safe**.
7. Click **Publish**.

### [configuration.mdx](docId\:amcyrSqPEVelSryjVZUFT)Creating advertising consent and associating the bounce status field

1. Open Microsoft Dynamics CRM and select **Settings** > **Advertising Consents**.

   ![Image: Advertising Consents](https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/BRuMlrfcJ6ZPmEf6fF9Ki-20260720-145419.png "Image: Advertising Consents")
2. Click **New**.

   ![Image: New advertising consent](https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/1Kc4EyUDymy2XqqyQG8ro-20260720-145419.png "Image: New advertising consent")
3. For **Opt-in-ID**, enter a unique identifier. Do not use special characters or characters with accents. The Opt-in-ID should be intuitive, for example *OptinProductNewsletterEmailContact*. It will display, for example, when selecting advertising consent for sending a campaign.

   ![Image: Opt-in-ID](https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/aWTfasR-eqtzdKSHmNZJx-20260720-145419.png "Image: Opt-in-ID")
4. Optional: For **Description**, enter a description for the advertising consent.
5. For **Type**, select the communication channel (email, SMS or print (Germany only)) to which the advertising consent applies.

   ![Image: Consent type](https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/5pqKsDVRQNUkl3rQw8zD5-20260720-145420.png "Image: Consent type")
6. For **Entity**, select the customer type (**Contact** or **Lead** or **Account**) for which the advertising consent is used.

   ![Image: Select entity](https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/j2G9_YSTNTFQj8Ox-yDy9-20260720-145420.png "Image: Select entity")
7. For **Reference Bounce Field**, enter the name of the field indicating the functionality of the advertising consent. This is the name that automatically had *new\_* added when creating the field.

   ![Image: Reference Bound Field](https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/xzmyms_S5V7_8ENFDaPNv-20260720-145420.png "Image: Reference Bound Field")
8. For **Episerver Campaign** **client**, select the client used for sending the advertising consent by clicking the magnifying glass symbol.

   :::hint{type="info"}
   **Note**

   The allocation of a client to an advertising consent cannot be changed.
   :::

   ![Image: Episerver Campaign client](https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/nfmv6i7yQB5lcqEGjnAAS-20260720-145420.png "Image: Episerver Campaign client")
9. Click **Save & Close**. The new advertising consent is displayed in the overview list.

   ![Image: New advertising agreement](https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/pz83bkjVRiqNVDIJS_Grn-20260720-145420.png "Image: New advertising agreement")

Repeat steps 1–9 to add more advertising consents for the same channel. Additional advertising consents can refer back to the bounce status field that was already created. This applies to the entire channel, for example an **Email** channel.

You have successfully created an advertising consent. Irrespective of whether the agreements are obtained through an opt-in process in Optimizely Campaign or from another source, you will find the assignment of the advertising consents to the individual contacts, leads or accounts under the menu item **Opt-in Histories**.

![Image: Opt-in Histories](https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/hOEh8lQLyvGaiqfw-nKsh-20260720-145420.png "Image: Opt-in Histories")

In the **Opt-in History Assigned View** overview, you can see the advertising consents granted. If the advertising consent is withdrawn again, the entry can be deleted, or an **Opt-out** entry is created on basis of the unsubscribe response data. In this case, CRM uses the time stamp to recognize the current status of the withdrawn advertising consent. In both cases, no more mailings that require the corresponding consent are sent to this data record.

![Image: Assigned View: Opt-In History](https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/OZy9H4SOvxov9kImTvqVY-20260720-145420.png "Image: Assigned View: Opt-In History")

## Connecting the advertising consent to an Optimizely Campaign opt-in process

On the configuration page of the advertising consent, you find another **Opt-in** area where you can connect the created advertising consent to the opt-in process in Optimizely Campaign. This enables you to send opt-in mailings with a confirmation link via Optimizely Campaign.

Prerequisites:

- You completed configuring the integration, including an advertising consent.
- You created an [opt-in process](docId:1E5S4MmWzP3r8i1F0zA9e). You require the ID of the opt-in process and the ID of the opt-in recipient list used in the process.

To connect an advertising consent to a double opt-in process:

1. In the **Opt-in** area, in the **Synchronize Double Opt-in** field, select **Yes**.

   ![Image: Field Synchronize Double Opt-In](https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/YGFzZf7DQuSf6SVKRbLBn-20260720-145420.png "Image: Field Synchronize Double Opt-In")
2. In the **Opt-in Recipient List ID** field, enter the ID of the recipient list that is used in the opt-in process. To see the recipient list ID, open the Optimizely Campaign [menu](docId\:PmNPgvNucBrAG5Rw8f41f) and select **Administration** > **API overview** > **Recipient lists**.

   ![Image: Field Opt-In Recipient List-ID](https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/DJnRsDgSWVMUe0BQNrboP-20260720-145420.png "Image: Field Opt-In Recipient List-ID")
3. In the **Opt-in Process ID** field, enter the ID of the Opt-in process from Optimizely Campaign. To see the opt-in ID, open the Optimizely Campaign[ menu](docId\:PmNPgvNucBrAG5Rw8f41f) and select **Administration** > **API overview** > **Opt-in processes**.

   ![Image: Field Opt-In Process-ID](https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/1J5Uz5xpkCOOMPvY40LcG-20260720-145420.png "Image: Field Opt-In Process-ID")
4. Optional: In the **Konfiguration DOI field**, enter a XML configuration that assigns information from the contact fields to the recipient list fields in the opt-in recipient list.

   :::hint{type="info"}
   **Note**

   The entry in `<optinsource>` is freely customizable. Note that the root node is named `<episerver>` here.
   :::

   ![Image: Field Konfiguration DOI](https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/UZv4PBNXLvqgg_QvH0zvg-20260720-145420.png "Image: Field Konfiguration DOI")
5. Click **Save & Close**.

   ![Image: Save & Close](https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/EHwQF2aVaMBYc3pnTKkpo-20260720-145420.png "Image: Save & Close")

You have successfully combined an advertising consent in CRM with an opt-in process in Optimizely Campaign. You can now trigger the sending of an opt-in mailing via Optimizely Campaign by clicking the **Send Opt-in Mail** button in the respective entity.

## Customizing the campaign activity form

To complete the configuration, update the campaign activity form adding fields from the Microsoft Dynamics integration. These fields are usually added when the integration is installed. However, depending on your CRM configuration, this step may have been missed.

The integration has these fields:

| No. | Field name                             |
| --- | -------------------------------------- |
| 1   | Recipients sent to Optimizely Campaign |
| 2   | Sent successful                        |
| 3   | Recipient Packages created             |
| 4   | Mailing Description                    |
| 5   | Mailing ID                             |
| 6   | Mailing ID by Wave ID                  |
| 7   | Mailing name                           |
| 8   | Mailing Status                         |
| 9   | Optimizely Campaign client             |
| 10  | Recipient Packages sent                |
| 11  | Preprocessed recipients                |
| 12  | Wave ID                                |
| 13  | Advertising Consent                    |

Do the following:

1. In Microsoft Dynamics, go to **Settings** > **Customizations**.
2. Click **Customize the System**.
3. Select **Components** > **Entities** > **Campaign Activity** > **Forms**.

   ![Image: Select Forms](https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/W2BFcM8jKoJcoppC1tupl-20260720-145420.png "Image: Select Forms")
4. Click **Campaign activity** in the list to open the **Campaign Activity** form.
5. In the field explorer, from the **Filter** drop-down list, select **Custom Fields** and clear the **Only show unused fields** check box. The 13 fields from the Microsoft Dynamics Integration are shown.

   ![Image: Select Custom fields filter](https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/6duFqTmwS7WCuDJ3ZaQGr-20260720-145420.png "Image: Select Custom fields filter")
6. Drag the 13 fields into the **Episerver Campaign** area of the structure view of the form.

   ![Image: Drag fields](https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/2KeJ-p6VUVFVtA7ssYGgi-20260720-145420.png "Image: Drag fields")
7. Click **Save and Close**.

## Transferring data fields

When transferring data fields from the CRM to Optimizely Campaign, a distinction is made between [data fields transferred by default](docId\:amcyrSqPEVelSryjVZUFT) and [additional optional fields](docId\:amcyrSqPEVelSryjVZUFT) that must be configured.

:::hint{type="info"}
**Note**

The integration transmits all values as a string, regardless of which data type is created in CRM.
:::

### [configuration.mdx](docId\:amcyrSqPEVelSryjVZUFT)Data fields transferred by default

The default settings for the integration send the following data from Microsoft Dynamics to Optimizely Campaign:

| Field name | Date type | Description                                      |
| ---------- | --------- | ------------------------------------------------ |
| entityType | String    | Indicates whether this is a lead or a contact    |
| salutation | String    | Title                                            |
| firstname  | String    | First name                                       |
| lastname   | String    | Last name                                        |
| fullname   | String    | First name and last name                         |
| mobile     | String    | Mobile phone number (required for SMS campaigns) |
| email      | String    | Email (required for email campaigns)             |
| street     | String    | Street                                           |
| city       | String    | City                                             |
| state      | String    | State                                            |
| zip        | String    | Zip code                                         |
| country    | String    | Country                                          |

### [configuration.mdx](docId\:amcyrSqPEVelSryjVZUFT)Configuring additional fields for the recipient list

This configuration applies to both campaign management and synchronization of recipient lists and advertising consents (clients). Remember to consider this during planning to avoid costly reconfiguration and additional work. The field configurations must be identical for both **leads** and **contacts**. Changing only one type will cause the other to fail to send.

Options for custom configuration of recipient lists:

- **Remap** a custom CRM field and write it to an existing standard field in the recipient list.
- **Transfer** a custom CRM field to an additional field not in the standard configuration of the recipient list.

### [configuration.mdx](docId\:amcyrSqPEVelSryjVZUFT)Remapping CRM fields

1. Open Microsoft Dynamics CRM and select **Settings** > **Mappings**.

   ![Image: Mappings](https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/puq2jUV8Hb2tNzilxppPR-20260720-145420.png "Image: Mappings")
2. Click **New**.
3. For **Entity**, select the type **Contact**.

   ![Image: Select Contact entity](https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/Qf032MSYp4H77Cp5InxMS-20260720-145420.png "Image: Select Contact entity")
4. In the **Map From** box, enter the name of the field in CRM.
5. For **Map To**, select the standard field in the recipient list into which the value of the CRM field should be written. For example, if you created a field called *new\_custom\_country*, then you can copy the value of this field into the **Country** field in the recipient list. The standard CRM **Country** field is no longer transferred to Optimizely Campaign.

   ![Image: Select Map to option](https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/sRI5FPEOWFthkc6RnTSJQ-20260720-145420.png "Image: Select Map to option")
6. Click **Save**.

Repeat steps 1–6 for type **Lead** (at step 3, select **Lead** under **Entity**).

### [configuration.mdx](docId\:amcyrSqPEVelSryjVZUFT)Transferring CRM fields

Prior to transferring, contact [customer support](docId\:ZWe1T3UPz3JW6_4mc76qV) to add the additional fields to your recipient list. In the request, provide the fields in a consecutively numbered list starting at 1, including numbering and field names. Note the numbering and field names (do not change them), you will need these for the configuration.

Do the following when the fields have been added:

1. Go to **Settings** > **Episerver Campaign** > **Episerver Campaign** **Mappings** in Microsoft Dynamics CRM.
2. Click **New**.
3. For **Entity**, select **Contact**.
4. In the **Map From** box, enter the name of the CRM field.

   ![Image: Map from CRM](https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/iVlGMfUkdhvmUcm05ml45-20260720-145420.png "Image: Map from CRM")
5. For **Map To**, select **Custom**.

   ![Image: Map to options](https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/LjEgaFnbM0TsOThLzTnD8-20260720-145420.png "Image: Map to options")
6. In the **Field** box, enter the name of the additional recipient list field requested.

   ![Image: Select Field recipient list](https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/IWXPMkm1UlJpmOasOrv3l-20260720-145421.png "Image: Select Field recipient list")
7. In the **Position** box, enter the position number of the additional recipient list field. The position numbers are oriented to the order of the additional recipient list fields requested.

   ![Image: Enter position number](https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/voE5_DVc4IwDzJFrJepKV-20260720-145421.png "Image: Enter position number")
8. If the **Map From** field is of the OptionSet type, use **OptionSet Language** to select the language to use to transfer the values.

   ![Image: Set language](https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/a2i4J7Lh2p_9B8mZcOhhV-20260720-145421.png "Image: Set language")
9. Click **Save**.
10. Repeat steps 2–10 for type **Lead** (at step 4, select **Lead** under **Entity**).