Braze

Requirements

You must have the Developer or Admin role to set up a connector. If your organization uses custom roles, your role needs the Create Connectors permission. You also need access to create API keys in Braze.

This article shows you how to connect EmailShepherd to Braze, so you can export emails to Braze as email templates.

You set up the connector once for each workspace. After that, anyone who can export emails can send them to Braze without copying any code.

Get your Braze API key

1. Sign in to Braze.

2. Navigate to Settings > APIs and Identifiers > API Keys.

3. Click Create API Key.

4. Enter a name for the key, such as EmailShepherd.

5. Under permissions, select the Templates permissions, so EmailShepherd can create and update email templates.

6. If you want EmailShepherd to upload your images to Braze, also select the Media Library permissions.

   

7. Click Create API Key.

8. Copy the API key and keep it somewhere safe until you’ve set up the connector.

Don’t give the key any other permissions. EmailShepherd doesn’t need them.

You also need to know your Braze instance, such as US-01 or EU-01. You can see it in the address of your Braze dashboard. See Braze’s list of instances.

Set up the connector in EmailShepherd

1. In the sidebar, click Connectors.
2. On the Export Connectors tab, click Add connector.
3. In Connector Name, enter a name, such as Braze.
4. In Choose Integration, select Braze.
5. In Instance, select your Braze instance.
6. In API Key, paste the API key you created.
7. In Dynamic Content Profile, choose a dynamic content profile to use every time you export to Braze. To choose one each time you export instead, leave it as None.
8. Click Create Connector.

Choose where images are hosted

By default, exported emails link to images hosted by EmailShepherd. To host your images in Braze instead, tick Upload image library images to this connector during exports when you set up the connector.

When this is on, each export uploads the images from your image library to your Braze media library, and the template links to the copies in Braze. Images you added by URL aren’t uploaded.

Set up personalization for Braze

Braze uses Liquid for personalization and dynamic content, such as {{${first_name}}}.

To export your personalization tags and conditionals in Braze’s syntax, set them up in a dynamic content profile for Braze, then choose it in the connector or when you export.

Export an email to Braze

See How to export an email to your ESP.

Each locale is exported as a separate email template in Braze. You can create a new template, or overwrite any existing template in Braze.