Braze integration guide
Braze is a customer engagement platform that helps brands send personalized messages across email, push notifications, SMS, and in-app messaging, using real-time customer data to power cross-channel marketing campaigns.
To integrate Braze with EasyDMARC, please check the steps below:
Prerequisites:
- Admin access to your Braze account (specifically: permission to create REST API Keys under Settings → APIs and Identifiers)
- Knowledge of which Braze cluster your account is on (US-01 through US-08, EU-01, EU-02, AU-01) — visible in your Braze dashboard URL
- An active EasyDMARC account with admin permissions
Step 1: Identify Your Braze REST Endpoint
Braze hosts customers in different regional clusters. EasyDMARC needs to know which one to call. The fastest way to find yours:
1. Log in to your Braze dashboard.
2. Look at the URL in your browser's address bar — it will look like https://dashboard-NN.braze.com or https://dashboard-NN.braze.eu (where NN is 01, 02, etc).
3. Match your dashboard URL to the corresponding REST endpoint using the table below.
Dashboard URL → REST Endpoint
https://dashboard-01.braze.com → https://rest.iad-01.braze.com
https://dashboard-02.braze.com → https://rest.iad-02.braze.com
https://dashboard-03.braze.com → https://rest.iad-03.braze.com
https://dashboard-04.braze.com → https://rest.iad-04.braze.com
https://dashboard-05.braze.com → https://rest.iad-05.braze.com
https://dashboard-06.braze.com → https://rest.iad-06.braze.com
https://dashboard-07.braze.com → https://rest.iad-07.braze.com
https://dashboard-08.braze.com → https://rest.iad-08.braze.com
https://dashboard-01.braze.eu → https://rest.fra-01.braze.eu
https://dashboard-02.braze.eu → https://rest.fra-02.braze.eu
https://dashboard-01.braze.au → https://rest.au-01.braze.com.au
Tip: After creating your API Key (Step 2), Braze displays the correct REST endpoint directly on the API Key page — you can copy it from there. Either approach works.
Step 2: Create a Read-Only REST API Key in Braze
EasyDMARC requires a dedicated, scoped, read-only API Key. Do not reuse an existing key — keys cannot be edited after creation, and a dedicated key makes auditing and revocation cleaner.
1. In your Braze dashboard, navigate to Settings → APIs and Identifiers.
2. Open the REST API Keys tab.
3. Click Create API Key.
4. Set the Name to EasyDMARC (Read-Only Analytics) so it's easy to identify later.
5. Leave Whitelist IPs blank for now (EasyDMARC's egress IPs will be provided in your EasyDMARC connection screen if you wish to add them later).
6. Under Permissions, expand each section and tick only the following boxes:
Permission Group → Permissions to Enable
Campaign → campaigns.list, campaigns.data_series, campaigns.details
Canvas → canvas.list, canvas.data_series, canvas.details
Sends → sends.data_series
Email Lists / Addresses → email.unsubscribes.get, email.hard_bounces.get
7. Scroll to the bottom and click Save API Key.
8. Copy the API Key value immediately — Braze displays the full key only once on creation. After leaving this page, you will only see the last 4 characters.
9. Also copy the REST endpoint displayed at the top of the API Key page (this confirms your cluster from Step 1).
Important — do NOT enable any of these permissions:
Never tick: users.track, users.delete, messages.send, email.bounce.remove, email.spam.remove, subscription.status.set, or any transactional.send permissions. EasyDMARC is a read-only analytics consumer. Granting write permissions creates unnecessary risk and is not required for the integration to function. If you accidentally tick a write permission, delete the key and create a new one — keys cannot be edited after creation.
Step 3: Connect Braze in EasyDMARC
1. Log in to your EasyDMARC dashboard.
2. Navigate to Integrations in the left-hand menu.
3. Locate the Braze card and click Connect.
4. In the connection modal, fill in:
- Workspace Label — a friendly name for this connection (e.g. Production – US Marketing). This is shown in the EasyDMARC UI only.
- REST Endpoint — paste the endpoint from Step 1 / Step 2 (e.g. https://rest.iad-01.braze.com).
- REST API Key — paste the key you copied in Step 2.
5. Click Test Connection. EasyDMARC performs a GET /campaigns/list?limit=1 call to verify the credentials and permissions.
6. If the test succeeds, click Save & Activate. EasyDMARC will start the initial backfill of the last 14 days of campaign data — this typically completes within 10–30 minutes depending on the volume of campaigns in your workspace.
7. If the test fails, see the troubleshooting section below.
Step 4 (Optional): Connect Additional Workspaces
If your organization operates multiple Braze workspaces (e.g. one per app, region, or business unit):
1. Repeat Steps 2 and 3 for each workspace, generating a separate API Key in each.
2. Use distinct Workspace Labels to keep them separate in the EasyDMARC UI.
3. All connected workspaces appear in the same dashboard with a workspace-level filter.
If there are still questions or concerns that remain uncovered after checking this article, you can contact EasyDMARC Technical Support.
To integrate Braze with EasyDMARC, please check the steps below:
Prerequisites:
- Admin access to your Braze account (specifically: permission to create REST API Keys under Settings → APIs and Identifiers)
- Knowledge of which Braze cluster your account is on (US-01 through US-08, EU-01, EU-02, AU-01) — visible in your Braze dashboard URL
- An active EasyDMARC account with admin permissions
Step 1: Identify Your Braze REST Endpoint
Braze hosts customers in different regional clusters. EasyDMARC needs to know which one to call. The fastest way to find yours:
1. Log in to your Braze dashboard.
2. Look at the URL in your browser's address bar — it will look like https://dashboard-NN.braze.com or https://dashboard-NN.braze.eu (where NN is 01, 02, etc).
3. Match your dashboard URL to the corresponding REST endpoint using the table below.
Dashboard URL → REST Endpoint
https://dashboard-01.braze.com → https://rest.iad-01.braze.com
https://dashboard-02.braze.com → https://rest.iad-02.braze.com
https://dashboard-03.braze.com → https://rest.iad-03.braze.com
https://dashboard-04.braze.com → https://rest.iad-04.braze.com
https://dashboard-05.braze.com → https://rest.iad-05.braze.com
https://dashboard-06.braze.com → https://rest.iad-06.braze.com
https://dashboard-07.braze.com → https://rest.iad-07.braze.com
https://dashboard-08.braze.com → https://rest.iad-08.braze.com
https://dashboard-01.braze.eu → https://rest.fra-01.braze.eu
https://dashboard-02.braze.eu → https://rest.fra-02.braze.eu
https://dashboard-01.braze.au → https://rest.au-01.braze.com.au
Tip: After creating your API Key (Step 2), Braze displays the correct REST endpoint directly on the API Key page — you can copy it from there. Either approach works.
Step 2: Create a Read-Only REST API Key in Braze
EasyDMARC requires a dedicated, scoped, read-only API Key. Do not reuse an existing key — keys cannot be edited after creation, and a dedicated key makes auditing and revocation cleaner.
1. In your Braze dashboard, navigate to Settings → APIs and Identifiers.
2. Open the REST API Keys tab.
3. Click Create API Key.
4. Set the Name to EasyDMARC (Read-Only Analytics) so it's easy to identify later.
5. Leave Whitelist IPs blank for now (EasyDMARC's egress IPs will be provided in your EasyDMARC connection screen if you wish to add them later).
6. Under Permissions, expand each section and tick only the following boxes:
Permission Group → Permissions to Enable
Campaign → campaigns.list, campaigns.data_series, campaigns.details
Canvas → canvas.list, canvas.data_series, canvas.details
Sends → sends.data_series
Email Lists / Addresses → email.unsubscribes.get, email.hard_bounces.get
7. Scroll to the bottom and click Save API Key.
8. Copy the API Key value immediately — Braze displays the full key only once on creation. After leaving this page, you will only see the last 4 characters.
9. Also copy the REST endpoint displayed at the top of the API Key page (this confirms your cluster from Step 1).
Important — do NOT enable any of these permissions:
Never tick: users.track, users.delete, messages.send, email.bounce.remove, email.spam.remove, subscription.status.set, or any transactional.send permissions. EasyDMARC is a read-only analytics consumer. Granting write permissions creates unnecessary risk and is not required for the integration to function. If you accidentally tick a write permission, delete the key and create a new one — keys cannot be edited after creation.
Step 3: Connect Braze in EasyDMARC
1. Log in to your EasyDMARC dashboard.
2. Navigate to Integrations in the left-hand menu.
3. Locate the Braze card and click Connect.
4. In the connection modal, fill in:
- Workspace Label — a friendly name for this connection (e.g. Production – US Marketing). This is shown in the EasyDMARC UI only.
- REST Endpoint — paste the endpoint from Step 1 / Step 2 (e.g. https://rest.iad-01.braze.com).
- REST API Key — paste the key you copied in Step 2.
5. Click Test Connection. EasyDMARC performs a GET /campaigns/list?limit=1 call to verify the credentials and permissions.
6. If the test succeeds, click Save & Activate. EasyDMARC will start the initial backfill of the last 14 days of campaign data — this typically completes within 10–30 minutes depending on the volume of campaigns in your workspace.
7. If the test fails, see the troubleshooting section below.
Step 4 (Optional): Connect Additional Workspaces
If your organization operates multiple Braze workspaces (e.g. one per app, region, or business unit):
1. Repeat Steps 2 and 3 for each workspace, generating a separate API Key in each.
2. Use distinct Workspace Labels to keep them separate in the EasyDMARC UI.
3. All connected workspaces appear in the same dashboard with a workspace-level filter.
If there are still questions or concerns that remain uncovered after checking this article, you can contact EasyDMARC Technical Support.