optilyz Direct Mail Automation

optilyz is a direct mail automation platform that enables you to run more customer-centric, sustainable, and profitable direct mail campaigns. optilyz is used by hundreds of companies across Europe and empowers you to integrate letters, postcards, and self-mailers into your cross-channel marketing as well as automate and better personalize campaigns.

Use the optilyz and Braze webhook integration to send direct mail to your customers.


Requirement Origin Access Description
optilyz API Key

optilyz Your optilyz customer success manager will provide you with your optilyz API key. This API key will enable you to connect your Braze and optilyz accounts.
optilyz Automation ID

optilyz The automation ID can be found in a box on the page header. When logged into optilyz, you can navigate to the automation you want to send data into.

The automation must be activated first.


To integrate with optilyz, use the optilyz API to send recipient data to the Braze webhook.

Step 1: Create a Webhook Template in Braze

To create a webhook template, from the Braze dashboard, navigate to Templates & Media and select Blank Template under Webhook Templates. Name your template.

Step 2: Fill Out Your Template

In your new Webhook template, fill out the following fields:

  • Webhook URL: https://www.optilyz.com/api/v2/automations/OPTILYZ_AUTOMATION_ID/recipient
  • Request Body: Raw Text

In the following request body, you can use any Liquid personalization tags and build a custom request template according to optilyz’ API documentation.

The variation field is optional and can be used to define which design inside the automation should be used. If a variation is omitted, optilyz will assign one of the defined variations randomly.

    "address": {
        "title": "{{custom_attribute.${salutation}}}",
        "firstName": "{{${first_name}}}",
        "lastName": "{{${last_name}}}",
        "street": "{{custom_attribute.${street}}}",
        "houseNumber": "{{custom_attribute.${houseNumber}}}",
        "address2": "{{custom_attribute.${address2}}}",
        "zipCode": "{{custom_attribute.${zipCode}}}",
        "city": "{{custom_attribute.${city}}}",
        "country": "{{custom_attribute.${country}}}"
    "variation": {{custom_attribute.${designVariation}}}


Step 3: Define Request Headers and HTTP Method

optilyz also requires an HTTP Header for authorization and an HTTP method. In the Settings tab of the webhook editor, create a key-value pair and replace the OPTILYZ_API_KEY with your optilyz API key.

  • HTTP Method: POST
  • Request Headers:
    • Authorization: {{ 'OPTILYZ_API_KEY:' | base64_encode }}
    • Content-Type: application/json


Step 4: Preview Your Request and Save Your Template

Next, preview your request in the left-hand panel or navigate to the Test tab, where you can select a random user, an existing user, or customize your own to test your webhook. Remember to save your template before leaving the page!


Using This Integration

Create a campaign, select Webhook, and choose your template from the Saved Webhook Template list.
For more information, check out our documentation on Webhooks!

Use Cases

Running direct mail like a digital channel means moving away from mass mailings and leveraging the channel as part of your (digital) customer journeys.

Reach out to your optilyz customer success manager if you’re interested in understanding how companies in your industry leverage letters, postcards, and more to enhance their customer experience. Our best practice and benchmark database help us assist you in setting up high-performing automation. These may be geared at converting one-time buyers into loyal fans, exciting your most valuable customers, and preventing churn.

The benefits of a modern approach to direct mail are:

  • Increased conversion rates via increased relevance, additional use cases, easier A/B testing & cross-channel effects
  • Reduced effort via automation & an end-to-end solution
  • Reduced cost via frame contracts & cost transparency
New Stuff!