> For the complete documentation index, see [llms.txt](https://documentation.crossengage.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://documentation.crossengage.io/data-and-engagement-platform/messages/integrations/channels/direct-mail/optilyz/set-up-optilyz-integration.md).

# Set up Optilyz Integration

Before you begin, you will need the following:

* optilyz account
* CrossEngage account
* User addresses

## **Fetching an API Key**

An optilyz API key allows CrossEngage to connect to your optilyz account. To obtain it:

* [*Log in*](https://www.optilyz.com/dashboard/#/auth/signin) to your optilyz account.
* Click `Automations` in the left panel menu.
* Copy the API key located right under the title of the page.

<figure><img src="https://985110910-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0Hio8LJewN8lQY2Vlqy0%2Fuploads%2FBVVQjgpuhXR3Ag7JFPJc%2FOptilyz.png?alt=media&amp;token=6cecbdfa-ff4d-4b45-a944-3cdff4563f69" alt=""><figcaption></figcaption></figure>

## Setting Up an optilyz Integration in CrossEngage

* In the CrossEngage app, navigate to `Settings` > `Integrations`.
* Click the `Add new integration` button in the top right corner of the page.

<figure><img src="https://985110910-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0Hio8LJewN8lQY2Vlqy0%2Fuploads%2FAgS47R9XoM50Wg0ysO8G%2FIntegrations_new.png?alt=media&amp;token=f0b23923-4d5f-4b08-85d8-b97df995be9f" alt=""><figcaption></figcaption></figure>

* Search for optilyz, then click `Set up`.

<figure><img src="https://985110910-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0Hio8LJewN8lQY2Vlqy0%2Fuploads%2FEj3jX1a61NFlUZG4G9Od%2FIntegrations_Optilyz.png?alt=media&amp;token=95d2fd47-91f2-43e6-b91d-41ffd150bd90" alt=""><figcaption></figcaption></figure>

* Give the integration a descriptive name.
* Paste the API key that you copied from your optilyz account during the previous steps into the "API key" field and click `Connect`.

<figure><img src="https://985110910-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0Hio8LJewN8lQY2Vlqy0%2Fuploads%2FPwVoEVAl0MrV1ROsdUy4%2FIntegrations_Optilyz_Form.png?alt=media&amp;token=b8136ff8-4f21-425c-904e-5560a1101a77" alt=""><figcaption></figcaption></figure>

### Value Mapping

Value mapping allows you to pass user information from CrossEngage to optilyz so you can perform better content personalisation.

* It is possible to set up a value mapping at this point if you wish to do so. There are three types of value mapping that you can set up:
  * User Attributes
  * [Handlebars](https://documentation.crossengage.io/personalisation/personalisation)
  * Static Values

<figure><img src="https://985110910-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0Hio8LJewN8lQY2Vlqy0%2Fuploads%2FlII4i4wYxWJ8Ck5bw6q4%2FIntegrations_Optilyz_ValueMapping.png?alt=media&amp;token=7184d320-5b57-45ca-b589-23e70ae4d635" alt=""><figcaption></figcaption></figure>

<figure><img src="https://985110910-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0Hio8LJewN8lQY2Vlqy0%2Fuploads%2Fd9tzIFLLGTZrkpzUUtwj%2FIntegrations_Optilyz_Handlebars.png?alt=media&amp;token=1560a5da-4a0e-438b-b48a-61b5cde8a9a3" alt=""><figcaption></figcaption></figure>

<figure><img src="https://985110910-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0Hio8LJewN8lQY2Vlqy0%2Fuploads%2FGvCHrjXYvSIBSnUWSnjd%2FIntegrations_Optilyz_Static.png?alt=media&amp;token=7a01da8a-6d6e-4b4a-8bf8-e818b2c305f4" alt=""><figcaption></figcaption></figure>

* Click `Apply` to save the Integration.