Dynamo Developer DocsDynamo Developer Docs

Braze

Connect your Braze account to Dynamo with a read-only API key and Instance URL.

Braze Integration

Connect your Braze account to Dynamo in just a few minutes. You'll create a dedicated API key with read-only permissions, plus your Instance URL.

No write permissions are required. Dynamo only reads segment metadata and exports user data. It cannot create, update, or delete users, segments, campaigns, or any other resources in your Braze account.

Create a Braze API Key

In Braze, go to Settings → APIs and Identifiers.

Click Create New API Key.

Give it a descriptive name (e.g. Dynamo Integration).

Enable only the following permissions:

PermissionWhy we need it
segments.listShow a dropdown of your Braze segments to choose from. Read-only — cannot create or modify segments.
segments.detailsDisplay segment names and descriptions so you can confirm you selected the right one. Read-only — no changes are made.
segments.data_seriesShow the estimated size of each segment before syncing. Read-only — only retrieves aggregate counts.
users.export.segmentExport user data (e.g. emails or external IDs) from a selected segment for syncing. Read-only — a data export, not an import. No user profiles are modified.

Save and copy the API key.

Find your Instance URL

Your Braze REST API endpoint — for example:

https://rest.iad-01.braze.com

You can find it at Settings → APIs and Identifiers — it's displayed at the top of the page as "SDK Endpoint" or "REST Endpoint".

Enter your credentials in Dynamo

Once you have both the API Key and Instance URL, go to your organization's Integrations settings in Dynamo and add a new Braze integration. Dynamo will validate the credentials immediately to confirm the connection is working.

What you needWhere to find it
API KeySettings → APIs and Identifiers → Create New API Key
Instance URLSettings → APIs and Identifiers → REST Endpoint

📄 Download the Braze setup guide (PDF)

On this page