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 as one-way customer data synchronization from Braze to Voucherify or to use Braze events as Voucherify custom events. This way, you can create promotions targeted at specific customer groups segmented in Braze or trigger Voucherify actions that are based on tracking custom events.

​
Synchronize customers with Braze Canvas

You can 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.
RegionWebhook URL
Europehttps://braze.voucherify.io/braze/customer-webhook
United Stateshttps://us1.braze.voucherify.io/braze/customer-webhook
Asiahttps://as1.braze.voucherify.io/braze/customer-webhook
Remaining clustershttps://{cluster}.braze.voucherify.io/braze/customer-webhook (use your dedicated cluster)
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.
ParameterDefinition / Options / Mapping
email_addressMaps directly to Voucherify’s email field
first_nameConcatenates with last name into the customer’s name field
last_nameConcatenates with first name into the customer’s name field
countryMaps to Voucherify customer address (country)
cityMaps to Voucherify customer address (city)
phone_numberMaps to Voucherify customer address (phone)
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 webbooks 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 needs to 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:
{
    "event": "user_registered",
    "customer": {
        "source_id": "{{${user_id}}}"
    }
}
4

Configure request headers

Add the required parameters in the Request headers:
  • X-App-Token: Integration application ID.
  • X-App-Id: 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.
You can use the synchronized Braze Audiences as customer segments in Voucherify.Use brazeAudiences metadata to create a dynamic segment that will be used, for example, 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.
If you want to base your Braze distribution on Voucherify events, you can use two different ways.You can use Braze Canvas with the events Voucherify streams to Braze. These events can be used as an Entry rule with Action-based delivery.You can also use Voucherify Distributions, which cover more events. Select there Braze as a distribution channel to publish codes in response to order-related events like order canceled. Read the Getting Started with Distributions guide to learn more.
Last modified on March 5, 2026