---
title: Setting up Optilyz for print messages
slug: campaign/docs/setting-up-optilyz-for-print-messages
docTags: 
createdAt: 2026-07-20T15:45:01.932Z
---

## Overview

Optilyz is a third party solution for sending print messages. In Optilyz, you define *automations*, which are processes for sending print messages. These automations can be triggered from a Marketing Automation campaign via an [app connection](docId\:u1JjXABfIuf6zf6ixuTy6) node. For more information about Optilyz, see [optilyz.com](https://optilyz.com/).

## JSON structure for transmitting recipient information

The Optilyz RESTful API accepts recipient information in JSON format. For details about the API, please refer to the [Optilyz API documentation](https://www.optilyz.com/doc/api/#api-Recipients-EnqueueOneRecipient). The JSON text can be defined in the *message body* of an app connection. It can contain placeholders for dynamic values from a recipient list, which are enclosed in curly brackets (see [App Connections](docId\:u1JjXABfIuf6zf6ixuTy6)).

Examples for recipient information with dynamic values as JSON:

```javascript
{
"address": {
"firstName": "{firstname}",
"lastName": "{lastname}",
"street": "{street}",
"houseNumber": "{streetnumber}",
"zipCode": "{zip}",
"city": "{city}",
"country": "{country}",
"individualisation1": "{custom1}",
"individualisation2": "{custom2}",
"individualisation3": "{custom3}"
},
"variation": 1
}
{
"address": {
"fullName": "{name}",
"address1": "{streetwithstreetnumber}";
"zipCode": "{zip}",
"city": "{city}",
"country": "{country}"
},
"variation": 1
}
{
"address": {
"companyName1": "{companyname}",
"companyName2": "{department}",
"address1": "{streetwithstreetnumber}";
"zipCode": "{zip}",
"city": "{city}",
"country": "{country}"
},
"variation": 1
}
```

## Finding your Optilyz API key

**Context:** For triggering any Optilyz automation via an app connection, your account's *API key* is required.

**Prerequisites:** You have an Optilyz account.

1. Go to optilyz.com and log in to your account.
2. Go to menu item *Automations.*
3. Find your API key on top of your list.

## Finding an Optilyz Automation ID

**Context:** For triggering an Optilyz automation via an app connection, the automation's *Automation ID* is required.

**Prerequisites:** You have an Optilyz account and have created an automation.

1. Go to optilyz.com and log in to your account.
2. Click on the automation you want to trigger from your Marketing Automation campaign.
3. Find the Automation ID on top of the page.

## Creating an app connection for Optilyz

**Prerequisites:** You know the *API key* for your Optilyz account and the A*utomation ID* of the automation you want to use. You have prepared the JSON code for transmitting recipient information to Optilyz (see [above](docId\:JhLYn5CiiBiKtILTgTekj)).

1. In Optimizely Campaign, go to *Administration > App Connections*.
2. Below the list of app connections, click on *Create...*
3.  Enter a meaningful name (e.g. "Trigger Optilyz Automation ABC").
4. Configure the API Connection as follows:
   **HTTP Method:** POST
   **URL:** [https://www.optilyz.com/api/v2/automations/\[Automation](https://www.optilyz.com/api/v2/automations/\[Automation) ID from Optilyz]/recipient
   **Authentication method:** Basic Auth
   **Content Type:** application/json
   **Message Body:** JSON code for transmitting recipient information. *Notice:* Make sure all mandatory fields for the automation are mapped in the JSON!
   **User name:** Your Optilyz API key in base64 format
   **Password:** Not required, leave this field blank
5. Click *Save*.
   → The new app connection is now available when you add an *App Connection* node in the campaign editor of Marketing Automation.

## Using an Optilyz automation in an MA campaign

**Prerequisites:** You have prepared an app connection for triggering an Optilyz automation.

1. Create a Marketing Automation campaign (for details, see [Marketing Automation](docId\:rH-CVuXsKjRWjl4DSmNsl)).
2. Add a *Connect App* node.
3. In the *Connect App* node, select your app connection for Optilyz.
4. Finish the MA campaign and make sure that the recipient data contains the fields required for sending print messages.
5. Save the MA campaign.
   → The new MA Campaign will trigger print message sending through Optilyz.