Skip to main content
Prerequisite: Add Braze credentials to VoucherifyTo send events to Braze, connect your Voucherify project with Braze.
Voucherify distribution allows you assigning Voucherify incentives to custom attributes of user profiles in Braze. Later, you can use the custom attributes you received from codes in your Braze campaigns, for example by using them in connected content. You can assign:
  • Discount coupons
  • Gift cards
  • Loyalty cards
  • Referral codes
  • Promotion tiers
You can distribute incentives to Braze using:
  • Manual messages, which work as a one-time action that assign random codes or inform about promotion tiers to a chosen audience: Voucherify segment or a single customer.
  • Automated workflow that sends an incentive in response to an action taken by your users.
Voucherify can push codes or promotion tiers to Braze custom attributes automatically in response to the following triggers.Triggers that can push codes or promotion tiers:
  • Customer entered/left segment: The message is sent when a customer joins or leaves a segment in Voucherify.
  • Successfully published: The message is sent when the code from a campaign is published (assigned) to a customer in Voucherify.
  • Order status changed: The message is sent when the order changes its status to created, updated, paid, or canceled.
  • Reward redemption: The message is sent when a customer redeems a loyalty or referral reward.
  • Custom event: The message is triggered once Voucherify receives a particular custom event.
  • Loyalty points adjusted: The message is sent when loyalty points are added to or subtracted from the customer’s profile.
  • Customer rewarded loyalty points: The message is sent when a customer was rewarded loyalty points.
If a customer in Voucherify doesn’t exist in Braze, Voucherify distribution will create a new user profile in Braze. The source ID of the Voucherify customer will be used to create user ID in Braze.

​
Set up distribution

In Voucherify, go to Engagement > Distributions to Create distribution.
1

Provide name and select Trigger

Name your distribution and select the trigger.For a relevant trigger, select required options:
  • Campaign
  • Segment
  • Validation rule
  • Custom event
2

Choose Action

  • Notify customers about promotion. Select Promotion tier.
  • Send and publish unique codes from campaign. Select the campaign that will be the source of unique codes.
All the information regarding the incentive is sent from Voucherify and stored in Braze customer profiles alongside the environment it was sent from and in three formats (text, barcode, and QR).
3

Configure channels

In Channels, choose Braze as a channel. Map custom fields that will be added to the user profile in Braze.
  • For vouchers, map Voucher code to add the field representing the code of the published voucher, for example voucherify_campaign_code. The rest of the fields are optional.
  • For promotion tiers, map Promotion tier name and Promotion tier ID. The rest of the fields are optional.
This is where you decide how you want to label Voucherify properties as custom attributes in Braze.You don’t have to add that custom attribute in Braze earlier, as these custom attributes will be mapped automatically to the defined key.
4

Review and send

In Summary, check if the configuration is correct. Once everything’s ready, Save and send to deliver the codes or promotion tiers to user profiles in Braze.
Manual distribution is sent after 10 minutes delay. You can edit your distribution details in the meantime. Automated distribution starts immediately and a message is sent whenever the triggering event occurs. Each message assigns a code or promotion tier as a custom attribute to a user profile in Braze.

​
Use Voucherify custom attributes in your Braze campaign

Once the custom attribute with the code is added to the customer’s custom attributes in Braze, you can use it in your Braze campaigns. Edit the message body and add the custom attribute defined in the Voucherify distribution, for example voucherify_campaign_code. To display the unique code, use the liquid code {{custom_attribute.${voucherify_campaign_code}}}. You can see the code in your message preview for a relevant user. Explore other features for better use of Braze with Voucherify.
Before you use Braze custom attributes in Voucherify distributions for Customer entered/left segment, you need to add your Braze users to the Voucherify dashboard.To do this, you can:When importing Braze users as customers to Voucherify, use Braze user_id value to map it to source_id in Voucherify.Once imported, you can create a customer segment by filtering the source_id with a specific condition, for example starts with braze. You can also filter customers by metadata brazeAudiences with a specific Braze audience_id that’s stored in Voucherify customer profiles.
Some distribution triggers in the automated workflow can use validation rules. Validation rules work as additional conditions for triggering the incentive sendout.For example:
  • You can use a validation rule that will trigger the incentive sendout when the order status changes to “paid” and the order amount is above $100.
  • You can use a validation rule that requires the customer to belong to a VIP customer segment in Voucherify when a custom event is triggered.
You can use validation rules with the following distribution triggers:
  • Order status changed to created, update, paid, or canceled.
  • Custom event.
Experiment with what works best in your business scenario.
Last modified on March 11, 2026