> For the complete documentation index, see [llms.txt](https://docs.feedotter.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.feedotter.com/integrations/braze.md).

# Braze

This guide covers how to connect and use Feedotter with Braze to automate email and newsletter production.

### About this integration

FeedOtter handles collecting the content and building the email. Braze handles the audience and delivery. Together, marketers can run recurring newsletters without rebuilding the email for every issue. FeedOtter writes each issue into a single Braze email template and sends it to the segment you choose. You can also link the send to a Braze campaign for reporting.

### Use cases

* **Automated newsletters and blog digests**: Automatically transform newly published WordPress, Drupal, or CMS content into branded Braze emails.
* **Personalized content notifications**: Match newly published articles, research, or other content to Braze segments.
* **Data-driven emails and alerts**: Turn information from APIs, databases, XML, JSON, spreadsheets, or secure data feeds into recurring Braze communications.
* **Editorial newsletters**: Automatically create complete, ready-to-review newsletters in Braze while allowing editors to curate articles, advertising, and other content before sending.
* **RSS-to-email automation**: Automate traditional RSS and content-feed emails in Braze, with support for more sophisticated multi-source workflows when needed.

***

### Prerequisites

Before you start, you need the following:

| Prerequisite                | Description                                                                                                                                                                                                                                                                                                                                                                                                      |
| --------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| A FeedOtter account         | A Feedotter account is required to take advantage of this partnership.                                                                                                                                                                                                                                                                                                                                           |
| A Braze REST API key        | <p>A Braze REST API key with the following permissions:<br>- <code>campaigns.list</code><br>- <code>campaigns.details</code><br>- <code>segments.list</code><br>- <code>templates.email.create</code><br>- <code>templates.email.update</code><br>- <code>messages.send</code><br>- <code>messages.schedule.create</code><br><br>Create this key in the dashboard from <strong>Settings > API Keys</strong>.</p> |
| A Braze REST endpoint       | Your Braze REST endpoint, for example `https://rest.iad-01.braze.com`. It depends on your Braze instance.                                                                                                                                                                                                                                                                                                        |
| A Braze App ID              | Any App ID in your workspace, found under **Settings > APIs and Identifiers > App Identifiers**.                                                                                                                                                                                                                                                                                                                 |
| A Braze segment             | The audience that receives your newsletter.                                                                                                                                                                                                                                                                                                                                                                      |
| A Braze campaign (optional) | An API-triggered campaign with an Email message. Braze only reports metrics for sends linked to a campaign.                                                                                                                                                                                                                                                                                                      |

***

### Integrate FeedOtter

#### Step 1: Add a Braze connection in FeedOtter

1. In FeedOtter, go to **Settings > Integrations**.
2. Click **Add Integration** and select **Braze**.

#### Step 2: Enter your Braze API credentials

1. Enter a **Connection Label** (optional).
2. Enter your **REST Endpoint**, **Api Key**, and **App ID**.
3. Click **Save**.

<figure><img src="https://2086102864-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIdHBGk8cqznUpEqm5g1U%2Fuploads%2FPY414ToDfYG4eyz0Eh9p%2FBraze-Feedotter-Settings.png?alt=media&amp;token=a460aae7-1ef5-43ae-a11e-c1b44112b31f" alt=""><figcaption></figcaption></figure>

#### Step 3: Confirm the connection to Braze

1. Click the **Test** button and confirm the light goes green to indicate Feedotter can communicate with your Braze account.

***

### Use FeedOtter with Braze

#### Step 1: Configure the send

1. When publishing a newsletter in FeedOtter, select **Braze** and choose your Braze connection.
2. Choose a **Publishing Action**: **Create a new campaign and schedule a send**, or **Create a new template only** to finish sending in Braze.
3. Select a **Segment**.
4. *(Optional)* Select a **Campaign** to track metrics in Braze.
5. Choose **Send Now**, or **Schedule** with a date, time, and timezone.

<figure><img src="https://2086102864-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIdHBGk8cqznUpEqm5g1U%2Fuploads%2FXYFz2dO6Jd4NVxXdRfjw%2Fbraze-publish-details.png?alt=media&amp;token=5e25166f-4f1a-4841-8d09-79a87b56c4fe" alt=""><figcaption></figcaption></figure>

#### Step 2: Publish and view in Braze

1. Click **Publish**.
2. In Braze, go to **Campaigns** to view your campaign and the subsequent sends you orchestrated via Feedotter.

<figure><img src="https://2086102864-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIdHBGk8cqznUpEqm5g1U%2Fuploads%2FqFdLeppxvhoWSXbAzKjE%2Fbraze-campaign-details.png?alt=media&amp;token=ed02f107-a744-4086-8ea1-012bd23e8f51" alt=""><figcaption></figcaption></figure>

Need help? Contact <support@feedotter.com>.
