Skip to main content
Prerequisites
Use this tutorial to set up a basic scenario of code publication with Connected Content.
The script example below includes optimization parameters like caching and retry. This tutorial focuses on the essential Voucherify-specific parts.Read Optimize your Connected Content scripts for details on each optimization parameter.

​
Display fetched data in Braze messages

Use the following steps to display the data fetched from Voucherify in Braze messages.
1

Add connected content script to message template

Copy and paste the Connected Content script under the <body> tag in a message HTML template.
Connected content publication script
   {% assign braze_campaign_id = {{campaign.${api_id}}} %}
   {% assign customer_id = {{${user_id}}} %}
   {% assign source_id = braze_campaign_id | append: customer_id %}
   {% assign voucherify_campaign_id = "camp_XXXXXXXXXXXXXXXXXXXXXXXX" %}
   {% assign cache_id = source_id %}

   {% connected_content 
      https://api.voucherify.io/v1/publications?cache_id={{cache_id}}
      :method post
      :headers {
         "X-App-Id": "12345678-90QW-ERTY-UIOP-asdfghjklzxc",
         "X-App-Token": "MNBVCXZL-KJHG-FDSA-POIU-ytrewq098765"
      }
      :body campaign={{voucherify_campaign_id}}&customer={{customer_id}}&channel=Braze&source_id={{source_id}}
      :content_type application/json
      :cache_max_age
      :retry
      :save publication
   %}
2

Set up necessary Voucherify API details

Add from Voucherify:
  • campaign_id copied from the campaign details view in the Voucherify dashboard (line 4).
  • Your API endpoint. You can check it in Project settings > General > API endpoint (line 8).
  • Add publications address /v1/publications and the API method (lines 8-9). Don’t remove ?cache_id={{cache_id}}, as it reduces the number of API calls.
  • Add your API credentials for authentication (lines 11-12).
Connected content publication script
   {% assign braze_campaign_id = {{campaign.${api_id}}} %}
   {% assign customer_id = {{${user_id}}} %}
   {% assign source_id = braze_campaign_id | append: customer_id %}
   {% assign voucherify_campaign_id = "camp_XXXXXXXXXXXXXXXXXXXXXXXX" %}
   {% assign cache_id = source_id %}

   {% connected_content 
      https://api.voucherify.io/v1/publications?cache_id={{cache_id}}
      :method post
      :headers {
         "X-App-Id": "12345678-90QW-ERTY-UIOP-asdfghjklzxc",
         "X-App-Token": "MNBVCXZL-KJHG-FDSA-POIU-ytrewq098765"
      }
      :body campaign={{voucherify_campaign_id}}&customer={{customer_id}}&channel=Braze&source_id={{source_id}}
      :content_type application/json
      :cache_max_age
      :retry
      :save publication
   %}
3

Create snippet to display fetched data

Responses from the Voucherify API are stored by connected content under the value of :save parameter. For example, :save publication in line 18.
Connected content publication script
   {% assign braze_campaign_id = {{campaign.${api_id}}} %}
   {% assign customer_id = {{${user_id}}} %}
   {% assign source_id = braze_campaign_id | append: customer_id %}
   {% assign voucherify_campaign_id = "camp_XXXXXXXXXXXXXXXXXXXXXXXX" %}
   {% assign cache_id = source_id %}

   {% connected_content 
      https://api.voucherify.io/v1/publications?cache_id={{cache_id}}
      :method post
      :headers {
         "X-App-Id": "12345678-90QW-ERTY-UIOP-asdfghjklzxc",
         "X-App-Token": "MNBVCXZL-KJHG-FDSA-POIU-ytrewq098765"
      }
      :body campaign={{voucherify_campaign_id}}&customer={{customer_id}}&channel=Braze&source_id={{source_id}}
      :content_type application/json
      :cache_max_age
      :retry
      :save publication
   %}
This enables you to retrieve and display data from a Voucherify response in Braze messages.
4

Display fetched data in messages

To display the published code in a message template, create a snippet that fetches a unique code from the voucher object:
{{publication.voucher.code}}
Each customer will get a message with a unique code automatically assigned to their profile. Each time the user receives a code, it is published to their profile in Voucherify.
Experiment with different data fieldsYou can fetch any field from Voucherify’s response.For gift cards, you can also display gift card balance by using the following snippet:
Your gift card: {{publication.voucher.code}}.

Your balance: {{publication.voucher.gift.amount}}.
See POST Create publication for the full response schema.
5

Set up rate limiter

When setting up a campaign target, use advanced settings to limit the number of messages sent per minute.Rate limits protect your API quota during testing and live traffic. Uncontrolled sending can exhaust code pools or exceed API limits.Read more about rate limiting and frequency capping in Braze documentation.
The script is ready. Send test messages with Test Send before launching. Braze preview mode doesn’t display Connected Content calls with a retry attribute. In Voucherify, go to Audit logs to check if Braze called the API successfully.

​
Next steps

Visit the following pages to achieve more with Voucherify and Braze Connected Content:
Last modified on March 26, 2026