Skip to main content
Prerequisite: Add Braze credentials to VoucherifyTo send data from Braze to Voucherify, generate API credentials in your Voucherify project first.
Use Braze Canvas webhooks to synchronize customer data from Braze to Voucherify or to send Braze events as Voucherify custom events. This lets you create promotions targeted at Braze segments or trigger Voucherify actions based on custom events.

​
Synchronize customers with Braze Canvas

Use Braze Canvas webhooks to synchronize Braze customer data with Voucherify.
1

Create a new Canvas

In Braze, create a new Canvas using the Canvas Flow editor.
2

Select webhook message

Create a Message and select Webhook to Compose webhook.
3

Compose webhook

Set the following details:
  • In Webhook URL, enter the URL of the endpoint: https://{yourCluster}.braze.voucherify.io/braze/customer-webhook.
  • In HTTP method, set POST.
  • In Request body, set JSON Key/Value Pairs.
Use the webhook URL for your region.
4

Configure request body

Enter the required parameters in the Request Body:
  • action: Use add to add members to the audience or delete to remove them.
  • user_id: Use personalization in the editor to add a Braze user ID, for example, {{${user_id}}}.
  • audience_id: Add the ID of the audience to update, for example, 608.
You can use the following optional fields to synchronize additional details.
5

Configure request headers

Add the required parameters in the Request headers:
  • applicationId: Integration application ID.
  • secretKey: Integration application token.
6

Test your message

Go to Test tab and Send test message to check if your configuration is correct.
In Voucherify, go to Audit log to check if the test message has been successfully sent. You’ll get a 200 status for POST method and the /v1/customers URL with Braze Outbound channel.Go to that log to see more details.
Once everything’s correct, click Done to save your message.
Your message is now saved in the Canvas. The brazeAudiences array in Voucherify customer metadata as well as other optional data will be updated whenever the relevant event occurs.
Go to the Canvas portal in Braze documentation to learn more.

​
Sending events with Braze webhook messages

Use Braze Canvas with webhooks as a message channel to send Braze events to Voucherify.

​
Configure general settings of the Canvas

Configure general settings of your Canvas.
1

Choose Entry schedule

As Entry schedule, select Action-Based.A user must perform an action to enter the Canvas workflow.
2

Select the custom event

In Action Based Options, select the Perform Custom Event and Add trigger. Select the custom event the customer needs to perform.
If you stream Voucherify events to Braze, you can also select a Voucherify event as a custom event.
3

Set Entry window

In Entry window, provide a start time when customers will start entering the Canvas.Optionally, you can set up an End time.
4

Configure target audience

In Target Audience, choose All Users.
5

Configure send settings

In Send Settings, choose All users including unsubscribed users.

​
Build Canvas

Configure your Canvas to send events from Braze to Voucherify.
1

Select webhook message

Create a Message and select Webhook to Compose webhook.
2

Compose webhook

Set the following details:
  • In Webhook URL, enter the URL of the endpoint: https://{yourCluster}.voucherify.io/v1/events.
  • In HTTP method, set POST.
  • In Request body, set Raw Text.
3

Configure request body

In Insert Raw Text, add the payload for the track event endpoint, for example:
4

Configure request headers

Add the required parameters in the Request headers:
  • X-App-Id: Integration application ID.
  • X-App-Token: Integration application token.
5

Test your message

Go to Test tab and Send test message to check if your configuration is correct.
In Voucherify, go to Audit log to check if the test message has been successfully sent. You’ll get a 200 status for POST method and the /v1/events URL with API channel.Go to that log to see more details.
Once everything’s correct, click Done to save your message.
Your message is now saved in the Canvas. Combine data sent from Braze to Voucherify with the following features for better incentive optimization.
Use synchronized Braze audiences as customer segments in Voucherify.Use brazeAudiences metadata to create a dynamic segment for use in:
  • Validation rules to target incentives to specific Braze audience.
  • Distributions to trigger additional distribution layers or for tracking using Distribution webhooks based on segments.
  • Dynamic formulas to calculate discounts or loyalty points.
As you can use Braze Canvas webhook messages to call the POST Track custom events endpoint in Voucherify, you can further experiment with the following cases:
  • Mark a referral as complete by forwarding a Braze event to Voucherify.
  • Give a free item voucher to a customer when they register on your website.
  • Add points to a customer loyalty card when they left a review in your portal.
  • Give a discount coupon when a customer abandoned their cart.
You can base Braze distributions on Voucherify events in two ways:
  • Use Braze Canvas with events Voucherify streams to Braze. These events work as Entry rules with Action-based delivery.
  • Use Voucherify Distributions with Braze as a channel. This covers more event types, such as publishing codes in response to order-related events like order canceled. Read the Getting Started with Distributions guide to learn more.
Last modified on June 22, 2026