Skip to main content
Prerequisite: Add Braze credentials to VoucherifyTo send events to Braze, connect your Voucherify project with Braze.
Voucherify distributions let you assign incentive codes to custom attributes on Braze user profiles. You can then use these custom attributes in your Braze campaigns, for example in Connected Content scripts or message personalization. You can assign:
  • Discount coupons
  • Gift cards
  • Loyalty cards
  • Referral codes
  • Promotion tiers
You can distribute incentives to Braze using:
  • Manual messages: A one-time action that assigns random codes or sends promotion tier details to a chosen audience (a Voucherify segment or a single customer).
  • Automated workflow: Sends an incentive in response to a specific customer action.
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 Voucherify customer doesn’t exist in Braze, the distribution creates a new Braze user profile. The Voucherify customer source_id is used as the Braze user_id.

​
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.
Voucherify sends the incentive data to Braze customer profiles. The data includes the environment it was sent from and the code 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, verify the configuration. When ready, click Save and send to deliver the codes or promotion tiers to Braze user profiles.
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. Learn more about related features when using Braze custom attributes.
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 to Voucherify, map the Braze user_id to the Voucherify source_id.Once imported, create a customer segment by filtering source_id with a condition like starts with braze. You can also filter by the brazeAudiences metadata field with a specific Braze audience_id 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 26, 2026