Braze

This page describes how to use Census with Braze.

๐Ÿƒโ€โ™‚๏ธ Getting Started

To connect to Braze, Census needs two pieces of information to connect to your Braze account:

  • An API Key with the appropriate permissions

  • The Braze API Endpoint URL for your account

1. Create a Braze API key

Braze lets you create a number of API keys, each with their own set of permissions. You'll almost certainly want to create a new API key for Census rather than reusing an existing one.

Within Braze's left navigation bar, scroll down to the very bottom. Under App Settings and click Developer Console.

Then, inside the API Settings tab, under Rest API Keys, click + Create New API Key.

Provide a name you'll recognize ("Census" is a good choice) and select the following permissions:

  • All User Data permissions, except for users.delete

  • segments.list

  • This permission set may change as we add support for more Braze objects so you may want to grant more permissions now or plan to update these permissions in the future.

Scroll down and click Save API Key.

Finally, copy the long code you see under Identifier. We'll use that in a minute.

2. Select your Braze API Endpoint

Braze requires that we use a slightly different URL to access your account depending on where it's been set up. See the full list of all Braze API Endpoints. In general, you just need the number from the URL you see in your browser when you're signed into Braze. For example, if your Braze URL is https://dashboard-03.braze.com/, then your API Endpoint should be https://rest.iad-03.braze.com.

3. Create the Census Connection

Great! Now let's pull it all together.

  1. In the Settings tab, Create a new Braze Service Connection in Census.

  2. You can provide whatever name you like.

  3. Provide the appropriate Braze Endpoint URL.

  4. Copy and paste your new Braze API key.

    โ€‹โ€‹

And you're all set and ready to get syncing! ๐ŸŽ‰

๐Ÿ—„ Supported Objects

Census currently supports syncing to the following Braze objects.

Object Name

Supported?

Identifiers

User

โœ…

External User ID

โ€‹Contact us if you want Census to support more objects for Braze.

๐Ÿ”„ Supported Sync Behaviors

Learn more about all of our sync behaviors on our Core Concepts page.

Behaviors

Supported?

Objects?

Update or Create

โœ…

User

โ€‹Contact us if you want Census to support more Sync Behaviors for Braze.

๐Ÿš‘ Need help connecting to Braze?

Contact us via [email protected] or start a conversion via the in-app chat.