Braze Setup Guide link
The way Fivetran connects Braze to your destination depends on whether you want to sync Braze Currents data and your cloud storage service. Follow the setup instructions for your cloud storage service.
Prerequisiteslink
To connect your Braze account to Fivetran, you need:
- A Braze account with active subscription and admin privileges
- Braze API URL
- Braze API key
- A Fivetran account with Account Administrator privileges
- (Recommendation) A Braze Current connected to Google Cloud Storage, Amazon S3, or Microsoft Azure Blob Storage
Setup instructions without Braze Currents datalink
Create API keylink
Log in to your Braze dashboard at https://dashboard.braze.com or your designated dashboard URL. See Braze's endpoints documentation for a complete list of URLs.
In the bottom left corner of your Braze dashboard, click Developer Console.
Follow Braze's API key guide to create an API key for Fivetran. Enable the following permissions for the API key:
- users.export.ids
- users.export.segment
- email.unsubscribe
- email.hard_bounces
- messages.schedule_broadcasts
- campaigns.list
- campaigns.details
- canvas.list
- canvas.details
- segments.list
- segments.details
- purchases.product_list
- events.list
- feed.list
- feed.details
- templates.email.info
- templates.email.list
- subscription.status.get
- subscription.groups.get
Make a note of the API key. You will need it to configure Fivetran.
Finish Fivetran configurationlink
In the connector setup form, enter the Destination schema name of your choice.
Enter the API URL and API Key you created in Step 1.
Select the Cloud Storage as Do Not Sync Braze Current Data.
Click Save & Test. Fivetran will take it from here and sync your data from your Braze account.
Setup instructions - Google Cloud Storagelink
Find Fivetran emaillink
In the connector setup form, select the Cloud Storage as Google Cloud Storage.
Make a note of the email address. You will need it to grant Fivetran access to your Google Cloud Storage bucket.
Create API keylink
Log in to your Braze dashboard at https://dashboard.braze.com or your designated dashboard URL. See Braze's endpoints documentation for a complete list of URLs.
In the bottom left corner of your Braze dashboard, click Developer Console.
Follow Braze's API key guide to create an API key for Fivetran. Enable the following permissions for the API key:
- users.export.ids
- users.export.segment
- email.unsubscribe
- email.hard_bounces
- messages.schedule_broadcasts
- campaigns.list
- campaigns.details
- canvas.list
- canvas.details
- segments.list
- segments.details
- purchases.product_list
- events.list
- feed.list
- feed.details
- templates.email.info
- templates.email.list
- subscription.status.get
- subscription.groups.get
Make a note of the API key. You will need it to configure Fivetran.
Grant bucket accesslink
Go to your Google Cloud Storage console.
Find the bucket that you configured the Braze Current with. Click Edit bucket permissions.
Grant
Storage Object Viewer
access to the Fivetran email address you found in Step 1.Make a note of your bucket name. You will need it to configure Fivetran.
Finish Fivetran configurationlink
In the connector setup form, enter the Destination schema name of your choice.
Enter the API URL and API Key you created in Step 2.
Enter the Bucket Name that you found in Step 3. You can also find the Bucket name in your Braze dashboard (Go to Integration > Current > your-current-name > Bucket Name).
Enter the Folder name. You can find the folder name in your Braze dashboard (Go to Integration > Current > your-current-name > Prefix).
Click Save & Test. Fivetran will take it from here and sync your data from your Braze account.
Setup instructions - Amazon S3link
Find External ID link
In the connector setup form, select the Cloud Storage as Amazon S3.
Make a note of the External ID. You will need it to allow Fivetran access to your S3 bucket.
Create API keylink
Log in to your dashboard at https://dashboard.braze.com or your designated dashboard URL. See Braze's endpoints documentation for a complete list of URLs.
In the bottom left corner of your Braze dashboard, click Developer Console.
Follow Braze's API key guide to create an API key for Fivetran. Enable the following permissions for the API key:
- users.export.ids
- users.export.segment
- email.unsubscribe
- email.hard_bounces
- messages.schedule_broadcasts
- campaigns.list
- campaigns.details
- canvas.list
- canvas.details
- segments.list
- segments.details
- purchases.product_list
- events.list
- feed.list
- feed.details
- templates.email.info
- templates.email.list
- subscription.status.get
- subscription.groups.get
Make a note of the API key. You will need it to configure Fivetran.
Create IAM policylink
Open the Amazon IAM console.
Click Policies, then Create Policy.
Click the JSON tab.
Copy the following policy, replacing
{your-bucket-name}
with the name of your S3 bucket.{ "Version": "2012-10-17", "Statement": [ { "Effect": "Allow", "Action": [ "s3:Get*", "s3:List*" ], "Resource": "arn:aws:s3:::{your-bucket-name}/*" }, { "Effect": "Allow", "Action": [ "s3:Get*", "s3:List*" ], "Resource": "arn:aws:s3:::{your-bucket-name}" } ] }
content_copyClick Review Policy.
Name the policy something memorable (for example, "Fivetran-S3-Access").
Click Create Policy.
Create IAM rolelink
Click Roles, then Create New Role.
Select Another AWS Account, then enter Fivetran's account ID,
834469178297
, in the Account ID field.Click the checkbox for the Require external ID option.
Enter the external ID you found in Step 1.
Click Next: Permissions.
Select the policy that you created earlier (for example, "Fivetran-S3-Access").
Click Next: Review.
Name your new role (for example, "Fivetran").
Click Create Role.
Click the role you just created.
Find the Role ARN and make a note of it. You will need it to configure Fivetran.
(Optional) Set permissions link
You can specify permissions for the Role ARN that you designate for Fivetran. Giving selective permissions to this Role only allows Fivetran to sync what it has permissions to see.
(Optional) Enable User Profile Exports link
To sync the USER
and USER_ALIAS
tables, you must use the Enable User Profile Exports toggle in the connector setup form. You can choose either:
- Amazon S3: You must provide an S3 bucket to which Braze will write the User export files.
- No Export Storage: Braze will use their S3 storage and provide Fivetran with a link to the export files.
We recommend that you configure your own S3 bucket. You can either:
- Use the same S3 bucket you used for the Currents
- Use a different S3 bucket
To use your S3 bucket, do the following:
Log in to the Braze dashboard.
In the left menu, click Technology Partners.
On the Technology Partners page, select Amazon S3 Cloud Storage.
In the Data Export using AWS Credentials section, make a note of the Role ARN, AWS S3 Bucket Name, and AWS S3 Bucket Folder details. You will need them to configure Fivetran.
Finish Fivetran configurationlink
In the connector setup form, enter the Destination schema name of your choice.
Enter the API URL and API Key you created in Step 2.
Enter the Bucket name from the Braze dashboard (Go to Integration > Current > your-current-name > Bucket Name).
Enter the Role ARN you found in Step 4.
Enter the Folder name. You can find the folder name in your Braze dashboard (Go to Integration > Current > your-current-name > Prefix).
(Optional) Set the Enable User Profile Exports toggle to Enabled, and then choose your Export Storage. If you select Amazon S3, enter the details you found in Step 6.
Click Save & Test. Fivetran will take it from here and sync your data from your Braze account.
Setup instructions - Microsoft Azure Blob Storagelink
Select Azure Blob Storagelink
In the connector setup form, select the Cloud Storage as Azure Blob Storage.
Create API keylink
Log in to your Braze dashboard at https://dashboard.braze.com or your designated dashboard URL. See Braze's endpoints documentation for a complete list of URLs.
In the bottom left corner of your Braze dashboard, click Developer Console.
Follow Braze's API key guide to create an API key for Fivetran. Enable the following permissions for the API key:
- users.export.ids
- users.export.segment
- email.unsubscribe
- email.hard_bounces
- messages.schedule_broadcasts
- campaigns.list
- campaigns.details
- canvas.list
- canvas.details
- segments.list
- segments.details
- purchases.product_list
- events.list
- feed.list
- feed.details
- templates.email.info
- templates.email.list
- subscription.status.get
- subscription.groups.get
Make a note of the API key. You will need it to configure Fivetran.
Find connection stringlink
In the Microsoft Azure console, go to your storage account.
On the left navigation pane, select Access keys and then click Show Keys.
Find the Connection string and make a note of it. You will need it to configure Fivetran.
Grant container accesslink
In the Microsoft Azure console, go to your storage account.
Select Containers. Select the container that you configured the Braze Current with. Click Change access level.
In the Public access level drop-down menu, select Container (anonymous read access for containers and blobs) and then click OK.
Finish Fivetran configurationlink
In the connector setup form, enter the Destination schema name of your choice.
Enter the API URL and API Key you created in Step 2.
Enter the Connection String that you found in Step 3.
Enter the Container Name that you configured in Step 4. You can also find the Container name in your Braze dashboard (Go to Integration > Current > your-current-name > Container Name).
Enter the Prefix. You can find the prefix in your Braze dashboard (Go to Integration > Current > your-current-name > Prefix).
Click Save & Test. Fivetran will take it from here and sync your data from your Braze account.
Related articleslink
description Connector Overview
account_tree Schema Information
settings API Connector Configuration