> 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="/files/EH5wcK49F0AXoKKNoCdH" 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="/files/zfWLFaM1kVBGbSAJoguR" alt=""><figcaption></figcaption></figure>

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

<figure><img src="/files/eQgYPZRxzxX4NmHLSS0A" 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="/files/WmRVcgIuO0XjiFU8wkW5" 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="/files/PVJET8Mkk0KpWmEoZF9E" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/5ygH2virv1ExV0PFuNkS" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/aLdCQkcrDLv1CtLekFwz" alt=""><figcaption></figcaption></figure>

* Click `Apply` to save the Integration.