> ## Documentation Index
> Fetch the complete documentation index at: https://docs.voucherify.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Braze

> Connect Voucherify with Braze to deliver incentives, sync customer data, and trigger messages based on promotion events

Voucherify handles incentive logic: code generation, validation, redemption, and budget control. Braze handles delivery: timing, channel selection, and message personalization. Together, they let you distribute the right incentive at the right time through the right channel.

## Integration options

The Braze integration supports four patterns for moving data between the platforms. Each pattern serves a different use case.

<img src="https://mintcdn.com/voucherify/ro02TV7CtHMTDmH9/images/docs/braze-integration-architecture.png?fit=max&auto=format&n=ro02TV7CtHMTDmH9&q=85&s=9b2cd5d49ebb0a639a9677cdcc77232b" alt="Braze integration architecture" width="1024" height="559" data-path="images/docs/braze-integration-architecture.png" />

| Pattern                                                                 | Direction                  | What it does                                                                                                                                     |
| ----------------------------------------------------------------------- | -------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------ |
| **[Connected Content](/integrations/braze-connected-content-overview)** | Braze calls Voucherify     | Fetches codes, balances, or gift card data from Voucherify at message send time. Best for real-time personalization.                             |
| **[Custom attributes](/integrations/braze-custom-attributes)**          | Voucherify pushes to Braze | Stores codes and promotion data on Braze user profiles via distributions. Best for pre-assigning codes before a campaign.                        |
| **[Promotion code lists](/integrations/braze-promotion-codes)**         | Manual export/import       | Exports codes from Voucherify in bulk and imports them into Braze promotion code lists. Best for large-scale, one-time distributions.            |
| **[Event streaming](/integrations/stream-events-to-braze)**             | Voucherify pushes to Braze | Sends promotion events (redemptions, publications, loyalty updates) to Braze. Best for triggering follow-up messages based on customer activity. |

You can also [send data from Braze to Voucherify](/integrations/send-data-from-braze) using Canvas webhooks to sync customer segments or forward Braze events as Voucherify custom events.

<Note>
  The Braze integration consumes **[API limits](/guides/limits#api-limits)** for Connected Content and **[webhook limits](/guides/limits#webhooks)** for custom attributes and audience sync. Plan your campaign volumes accordingly.
</Note>

## What you need to connect with Braze

Voucherify and Braze communicate both ways. You need credentials configured in each platform.

### Connect Voucherify with Braze

This connection lets Voucherify push events and custom attributes to Braze.

<Steps>
  <Step title="Copy the Braze REST API key">
    In your Braze account, create or locate a REST API key with at least the `users.track` permission.
  </Step>

  <Step title="Add the key in Voucherify">
    In Voucherify, go to **Home** > **Integrations**, find **Braze**, and click **Connect**. Paste the REST API key, select the Braze API endpoint for your cluster, and enable **Send events to Braze**.
  </Step>
</Steps>

### Connect Braze with Voucherify

This connection lets Braze call Voucherify APIs for Connected Content, Canvas webhooks, and other API-based integrations.

<Steps>
  <Step title="Generate integration keys in Voucherify">
    In **Home** > **Project Settings**, scroll to **Integration keys** and click **+**. Name your key, assign a role, and select **Braze** from the integration list. Click **Create integration API**.
  </Step>

  <Step title="Save your credentials">
    Copy the **Application ID** and **Secret key**. You will not be able to view the secret key again.
  </Step>

  <Step title="Use credentials in Braze">
    Add the Application ID and Secret key to your Braze Connected Content scripts, Canvas webhook headers, or other integration settings that require Voucherify authentication.
  </Step>
</Steps>

## Rate limiter

When configuring campaigns in Braze, [limit the number of messages](https://www.braze.com/docs/user_guide/engagement_tools/campaigns/building_campaigns/rate-limiting/#delivery-speed-rate-limiting) sent per minute. This protects both Braze and Voucherify APIs from excessive traffic.

Set the sending rate based on your Voucherify [API rate limits](/guides/limits#api-limits). Account for other API consumers in your project when calculating the limit.

## Next steps

Explore the following pages to match Voucherify to your Braze use cases.

<CardGroup cols={2}>
  <Card title="Connected Content" icon="plug" href="/integrations/braze-connected-content-overview">
    Fetch codes and loyalty data from Voucherify at send time.
  </Card>

  <Card title="Stream events to Braze" icon="arrow-right" href="/integrations/stream-events-to-braze">
    Use Voucherify events to trigger action-based delivery in Braze.
  </Card>

  <Card title="Send data from Braze" icon="arrow-left" href="/integrations/send-data-from-braze">
    Sync customer segments and forward events to Voucherify with Canvas webhooks.
  </Card>

  <Card title="Custom attributes" icon="user" href="/integrations/braze-custom-attributes">
    Push codes to Braze user profiles with Voucherify distributions.
  </Card>

  <Card title="Promotion code lists" icon="list" href="/integrations/braze-promotion-codes">
    Export codes in bulk and import them into Braze.
  </Card>

  <Card title="Speedrun loyalty with Braze" icon="rocket" href="https://www.voucherify.io/blog/speedrunning-loyalty-without-leaving-braze">
    Learn how to tweak and experiment in Voucherify to gain even better results with your Braze campaigns.
  </Card>
</CardGroup>