Braze
Connect Braze to update users, send campaigns and Canvases across every channel, manage catalogs and templates, and pull engagement reports.
You paste one Braze REST API key, made in your workspace under Settings, APIs and Identifiers. It works for that one workspace, holds only the permissions you tick, and PopMCP finds your Braze instance for you. You need a Braze customer account.
Paid plan required before this connector works
You need to be a Braze customer. Braze has no free plan, and access comes through its sales team, which also offers trials, startup programs and other entry plans. With an account, Braze reviews nothing: you can make a REST API key yourself.
- Typical wait
- None if your company already uses Braze and you can open Settings, APIs and Identifiers. Otherwise it is a sales conversation with Braze.
- Cost
- Set in your contract with Braze, and it scales with Monthly Active Users. On contracts priced by data points, each attribute written through the API uses one.
- Blocked until approved
- Without a Braze workspace there is nowhere to make a key. Some features are extras on the contract, such as Transactional Email, and those tools are refused until Braze turns the feature on.
- Works meanwhile
- If your company has Braze, ask a teammate who can open Settings, APIs and Identifiers to make the key with the permissions you need.
Where to apply: Talk to your Braze account manager, or to Braze sales at braze.com if your company is not a customer yet.
- Keys cannot be edited after they are made. Adding a permission means making a new key and reconnecting.
- A few endpoints need Braze to turn them on: Accounts for data objects, and the limited betas of users track bulk and sync.
- Dashboard user tools need a separate SCIM token, and Braze makes SCIM available depending on your edition.
- Setup time
- 3 min
- Auth
- API credentials
- API base URL
- One per instance, such as https://rest.iad-01.braze.com (US-01) or https://rest.fra-01.braze.eu (EU-01). PopMCP finds yours.
- Rate limits
- Set per endpoint and applied per workspace, and some depend on your contract: for example 250,000 requests an hour shared across many endpoints, 50 a minute for catalog management, and 100 a day for creating send ids. Over the limit, Braze answers HTTP 429 and its headers say when to retry, which PopMCP passes on.
Before you begin
- A Braze customer account. Braze has no free plan, and access comes through its sales team.
- A Braze role that lets you open Settings, APIs and Identifiers in the workspace you want to connect. If you can't see it, ask a teammate who can to make the key.
- A few features need Braze to turn them on first: Transactional Email, data objects (Accounts), and the limited betas of users track bulk and sync. Everything else works straight away.
Get your credentials
Open APIs and Identifiers
Sign in to the Braze dashboard, using the address you normally use, and switch to the workspace you want to connect. Open Settings, then APIs and Identifiers, and stay on the API Keys tab. A key belongs to one workspace, so check the workspace name first.
APIs and Identifiers
Keys belong to this workspace only.
| API Key Name | Created By |
|---|---|
| Website eventsUsed by the backend | dev@acme.example |
Create a key and tick its permissions
Choose Create API Key and name it something you will recognise, like PopMCP. Tick every permission you want the AI to use, because Braze keys can't be edited later: adding one means making a new key and reconnecting. For reports only, tick the list, details and data series permissions for campaigns, Canvases and segments, plus events.list and the kpi ones. To update users, add users.track and users.export.ids. To send, add messages.send, campaigns.trigger.send and canvas.trigger.send. Leave the IP allowlist empty, or PopMCP's calls will be refused.
Create API Key
Copy the Identifier
Back on the API Keys tab, find your new key. The value in the Identifier column is the REST API key. Copy it. Don't use the app identifiers or SDK keys on the same page: those won't connect.
APIs and Identifiers
| API Key Name | Identifier |
|---|---|
| PopMCPCreated just now | 9f3c****-****-****-****-********a41e |
Paste the key into PopMCP
Paste it into Braze REST API key. PopMCP tries the key on Braze's instances, remembers where it works, and tells you what it could read. Under More options, you can add a Workspace name, which is how the connection is labelled, since Braze's API doesn't share workspace names. Connecting fails only if Braze refuses the key everywhere. If you're sure the key is right, enter your dashboard address there too.
Connect in PopMCP
Open your workspace, choose Braze in the marketplace, and fill in the connect dialog:
| Field | What to enter |
|---|---|
| Braze REST API keysecret | From Settings > APIs and Identifiers > API Keys in Braze. The Identifier shown there is the key. Use a REST API key, not an SDK key. Stored encrypted, used server-side only.Encrypted with AES-256-GCM on save and never shown again. |
| Braze dashboard address (optional)text | We find this for you. Fill it in only if connecting fails, with the address you use for Braze or its instance name: US-01, US-02, US-03, US-04, US-05, US-06, US-07, US-08, US-10, EU-01, EU-02, AU-01, ID-01, JP-01, KR-01. |
| Workspace name (optional)text | What to call this workspace in PopMCP. Braze does not share workspace names with its API. |
| SCIM token (optional)secret | Only for tools that manage your team's Braze dashboard users. From Settings > Admin Settings > SCIM Provisioning.Encrypted with AES-256-GCM on save and never shown again. |
| SCIM service origin (optional)text | The service origin you set beside the SCIM token. |
PopMCP verifies the credential against Braze immediately. On success the connection flips to Verified and its MCP tools are provisioned.
Verify it worked
PopMCP shows Braze as Verified, labelled with your workspace name or Braze workspace, and the instance such as US-01. Ask for a map of your workspace: braze_get_workspace_overview answers with your newest campaigns, Canvases and segments, and names any permission the key lacks.
Troubleshooting
"Braze did not accept this key on any of its instances"
Why: The key was copied incompletely, is an SDK key, has allowed IP addresses set, or holds none of the permissions PopMCP reads first.
Fix: Copy the Identifier again. If it still fails, make a new REST API key with `campaigns.list` ticked and the IP allowlist empty.
"We don't recognise that Braze address"
Why: PopMCP only accepts Braze's own dashboard addresses and instance names.
Fix: Copy the address from your browser while signed in to Braze, such as `dashboard-01.braze.com`, use a name like `US-01`, or leave the field empty.
A tool answers that the key may not have a permission
Why: Keys hold only what was ticked when they were made, and a key made before a feature launched doesn't get it automatically.
Fix: Make a new key with that permission ticked, then reconnect Braze in PopMCP.
A tool answers 429, or says the rate limit is used up
Why: Braze limits each endpoint per workspace, and your other integrations share the limit. Some limits depend on your contract.
Fix: Wait as long as the answer says. Batching uses the limit less, because most endpoints take 50 ids in one call.
A send says success, but nobody got the message
Why: Success means Braze accepted the request. Delivery still depends on the user existing, their subscription state and the channel.
Fix: Check the campaign's numbers with braze_get_campaign_overview, and the person's profile with braze_find_user. Allow a few minutes after creating a user before an API-only send.
A dashboard user tool says it needs a SCIM token
Why: A REST API key can't manage dashboard users.
Fix: Make a token and service origin under Settings, Admin Settings, SCIM Provisioning, then reconnect Braze with both under More options. If you can't see that page, ask your Braze account manager about your edition.
Reference
beehiiv
Connect beehiiv to grow and manage subscribers, draft and schedule newsletter posts, track opens and clicks, and run segments and automations.
Brevo
Connect Brevo to manage contacts and lists, send email, SMS, and WhatsApp, run campaigns, and use the sales CRM. MCP setup guide for Claude and ChatGPT.