--- title: Extended recipient list connector slug: campaign/docs/extended-recipient-list-connector docTags: createdAt: 2026-07-20T15:44:29.033Z --- :::hint{type="info"} **Note** This topic is for administrators and developers with administration access rights in Microsoft Dynamics. ::: :::hint{type="info"} **Note** The documentation refers to connector version 1.584 and higher. ::: The current version of Microsoft Dynamics CRM cannot address more than 100,000 recipients per campaign. The extended recipient list connector for Optimizely Campaign is an external Windows service that removes the technical limitation and controls campaigns and the transmission of marketing lists with more than 100,000 recipients. ## Prerequisites - Installation file. Contact [customer support](docId\:ZWe1T3UPz3JW6_4mc76qV). - Microsoft Dynamics CRM online or on-premise (local) - SQL database, such as LocalDB or SQL Express. - Port reservation 1. Open the command prompt as administrator. 2. Run the `netsh` configuration program. 3. Reserve the port using the prompt `add urlacl url=http://+:20000/ user=domain\\username`. :::hint{type="info"} **Note** The specification of the port *+*:20000 must match the later port specification in the *IntegrationService.config* installation file. ::: ### Technical requirements - SQL server - Microsoft SQL Server 2008R2 (all versions with LocalDB) and later - Microsoft SQL Azure - Windows Identity Foundation 3.5 (Windows feature) - .NET Version 4.6.2 ## Installation 1. Unzip the installation file that you have received from the [customer support](docId\:ZWe1T3UPz3JW6_4mc76qV). 2. Open the *IntegrationService.exe.config* file in a text editor. 3. Optional: Configure the proxy settings. ```javascript ``` :::hint{type="info" indent="2"} **Note** The configuration does not replace the proxy configuration for the CRM. This is still necessary for functionalities such as double opt-in or transactional mails. ::: 4. Adjust the *connectionStrings* element as follows: ```javascript ``` :::Paragraph{indent="1"} **Microsoft Dynamics CRM online** ::: :::Paragraph{listStyleType="disc" indent="2"} For the *connectionString* parameter, prefix the URL with the parameter *AuthType=Office365*; as follows: ::: ```javascript connectionString="AuthType=Office365;Url={https://server/organization/}; Domain= ; Username= ; Password= ;" ``` :::Paragraph{listStyleType="disc" indent="2"} The parameters *Username* and *Password* are required. ::: :::Paragraph{indent="1"} **Microsoft Dynamics CRM on-premise** ::: :::Paragraph{listStyleType="disc" indent="2"} If you sign in using the following Windows services, the *Domain*, *Username*, and *Password* parameters are not required in the *connectionString*: ::: :::Paragraph{listStyleType="disc" indent="3"} Microsoft Dynamics CRM Asynchronous Processing Service (MSCRMAsyncService) ::: :::Paragraph{listStyleType="disc" indent="3"} Microsoft Dynamics CRM Sandbox Processing Service (MSCRM SandboxService) ::: 5. Save the *IntegrationService.exe.config* file. 6. Open the Command Prompt as administrator. 7. Enter the connector path and install the *Integrationservice.exe* file with the prompt `integrationservice.exe install`. ![Image: Command Prompt](https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/8VYnXatoW84jiKcRF-zsf-20260720-145416.png "Image: Command Prompt") 8. Open Windows Services and start *Episerver Campaign Integration Service*. :::hint{type="info"} **Note** If you want to update or modify the configuration, you must first stop the connector via Windows Services. ::: ## Configuring the connector In the *IntegrationService.exe.config* file, you can adjust the following parameters for the data transfer. | Parameter | Description | Default value | | ------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------- | | MaxSendRetries | Number of attempts to transmit a recipient package when an attempt fails, for example, due to a timeout. | 3 | | TimeoutCrmConnection | Maximum time in seconds for the transmission of a recipient package from the CRM to the service before a timeout error occurs. | 60 | | TimeoutEpiserverConnection | Maximum time in seconds for the transmission of a recipient package from the service to Optimizely Campaign before a timeout error occurs. | 120 | | UseSoapServiceForRecipientLists | Choice between data transfer via SOAP or REST API. REST API is used by default. | false | | BatchSize | Size of the recipient package when transferring from the service to Optimizely Campaign. When transferring using SOAP API, the maximum value is *1000*. | 5000 | | CrmBatchSize | Size of the recipient package when transferring from the CRM to the service. | 1000 | | MaxThreads | Number of parallel threads when transferring via API. The maximum number is *6*. | 5 | ## Configuration in Microsoft Dynamics CRM 1. Open Microsoft Dynamics CRM and select **Settings** > **Configurations**. ![Image: Configurations](https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/k0bp3GwxZq6qabNp3Uu1W-20260720-145416.png "Image: Configurations") 2. Click **New**. 3. Enter the name *Use Windows Service*. ![Image: Entering the name](https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/c6XBV-T9TfT_21RZQPqKp-20260720-145416.png "Image: Entering the name") :::hint{type="info"} **Tip** You can leave the **Value** field blank. No definition is required. ::: 4. Click **Save & Close**. ![Image: Saving the configuration](https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/Tht0d5iYT1osKb6lhyc-J-20260720-145416.png "Image: Saving the configuration") ## Troubleshooting With the **Hangfire** tool you can view and manage planned, running and executed workflows. You install Hangfire automatically with the connector and access the tool in your web browser at the following address: *http\://localhost*:20000*/hangfire*. To view the **log data** of the service, open the *logs.txt* file in the installation directory. You can find the log data of the past days in the *archives* folder. ## Uninstallation To uninstall and completely remove the extended recipient list connector, do the following: :::hint{type="info"} **Note** The extended recipient list connector must be inactive. Open Windows Services and stop *Episerver Campaign Integration Service*. ::: 1. Open the Command Prompt as administrator. 2. Enter the connector path and uninstall the *Integrationservice.exe* file with the prompt `integrationservice.exe uninstall`. ![Image: Command Prompt](https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/WaVMQO6JjdVJVO412jlaK-20260720-145416.png "Image: Command Prompt") :::hint{type="info"} **Tip** The installation directory still remains. Delete the directory including the log data. ::: 3. Open Microsoft Dynamics CRM and select **Settings** > **Configurations**. ![Image: Configurations](https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/Ia59JyknF4XVL1lbiAHxX-20260720-145416.png "Image: Configurations") 4. Select the *Use Windows Service* configuration data set and click **Delete**. ![Image: Deleting the configuration](https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/bgyGx2AlMVc4DrhVvEpm9-20260720-145416.png "Image: Deleting the configuration")