# Braze Output Streaming Integration

Braze is a customer engagement platform that helps brands of all sizes create personalized and targeted campaigns across various channels. Braze gives you the ability to listen to your customers, understand what their behavior is signaling, and then act by sending customers the right message, through the right channel, at the right time.

Using this integration, Treasure Data can send messages through Braze using either a campaign or a canvas flow.

## Prerequisites

- Basic Knowledge of Treasure Data.
- Basic knowledge of [Braze](https://www.braze.com/), including a knowledge of how to configure [campaigns and canvases](https://www.braze.com/docs/user_guide/getting_started/campaigns_canvases/) to send emails.


## API Information

Treasure Data uses the [/campaigns/trigger/send](https://www.braze.com/docs/api/endpoints/messaging/send_messages/post_send_triggered_campaigns/) permission or the [/canvas/trigger/send](https://www.braze.com/docs/api/endpoints/messaging/send_messages/post_send_triggered_canvases/) to direct Braze to send email messages. The documentation on the Request Body for these two APIs can be very helpful in setting up your email templates on Braze.

## Use Cases

The primary use case for this streaming integration is to incorporate it into a real-time activation workflow. Here is an overview of how to configure that workflow:

1. In the [Braze dashboard](https://dashboard.braze.com/sign_in), generate an API key for either the [campaigns.trigger.send](https://www.braze.com/docs/api/endpoints/messaging/send_messages/post_send_triggered_campaigns/) permission or the [canvas.trigger.send](https://www.braze.com/docs/api/endpoints/messaging/send_messages/post_send_triggered_canvases/) permission.
2. Create your Braze [email templates](https://www.braze.com/docs/user_guide/engagement_tools/templates_and_media).
3. In the TD Console, create an authentication for this integration to communicate with Braze.
4. In a Real-time Journey, select this authentication for a new triggered activation.


## Limitations

- There is a limit of 250 requests per minute for broadcast calls (when only specifying a segment or Connected Audience). Otherwise, Braze supports 250,000 requests per hour. (See [Braze rate limits by request type](https://www.braze.com/docs/api/api_limits/#rate-limits-by-request-type).)


## Obtaining the Braze API Key

To obtain your Braze API key:

1. Log in to the [Braze dashboard](https://dashboard.braze.com/sign_in).
![](/assets/screen-shot-2021-03-02-at-20.19.43.bd8e8ddaab558bc8d1a01321d0558a017618c426affa7aa153ede2d7c973251f.bcdb7aa7.png)
2. Select the **API Settings** tab and then select **+ Create New API Key**.
  - For campaign messages, you will need to generate an API key with the [campaigns.trigger.send](https://www.braze.com/docs/api/endpoints/messaging/send_messages/post_send_triggered_campaigns/) permission.
  - For canvas messages, you will need to generate an API key with the [canvas.trigger.send](https://www.braze.com/docs/api/endpoints/messaging/send_messages/post_send_triggered_canvases/) permission.
![](/assets/brazeapikey.1c5a02af69ff5e099138fe5519366219748602111c8f0411f90f9a8e6f72ae76.157ac480.png)
3. Store the API key in a safe and secure location. You will need this key to create the Braze authentication in TD Console.


## Use the TD Console to Create Your Connection

You must create and configure the data connection in Treasure Data. As part of the data connection, you provide authentication credentials to access the integration.

1. Open the **TD Console**.
2. Navigate to **Integrations Hub > Catalog**.
3. Select the search icon on the far right of the Catalog screen, and type **Braze Output Streaming**.
4. Hover over the Braze Output Streaming connector and select **Create Authentication**.
![](/assets/braze_streamingout.089ecffa43caf11648acdaf05125bd0cce1d53943b5e534fc4466fa98f7e3250.157ac480.png)
5. Enter the Braze API endpoint.
6. Enter the Braze API key.
![](/assets/brazeoutputstreamingauth.e2c5da40ed8769405650b553720eece3abd0a836f116dbe11bf6ec16e4dbc142.157ac480.png)
7. Select **Continue**.
8. Enter a name for your connection.
9. Select **Done.**


The Braze Output Streaming integration is now available to be incorporated into real-time customer journey activations. See [Creating a Real-time Triggered Activation](https://docs.treasuredata.com/smart/project-product-documentation/creating-a-real-time-triggered-activation) for additional information.