FAQ

Which Braze entities should I start with?

If you're building a marketing performance dashboard, start with Campaigns analytics and Canvases analytics — these have the most actionable metrics (sends, opens, clicks, conversions, revenue). Add KPI daily new users and KPI daily active users if you also want growth metrics in the same workspace.

What's the difference between the list, analytics, and details entities?

• List entities (Campaigns, Canvases, Segments, Events, Cards) return metadata — names, IDs, tags, active status.

• Analytics entities return time-series performance metrics — daily breakdowns of sends, opens, clicks, segment sizes, event counts, etc.

• Details entities return structural/configuration data — the actual setup of a campaign, the step logic of a canvas, or the filter rules of a segment.

For reporting, you'll mostly use analytics entities. Use list entities to enrich analytics data with human-readable names via a Join transformation.

How do I find my Braze REST endpoint URL?

In Braze, go to Settings → Developer Console. Your REST endpoint is displayed at the top of the page and looks like https://rest.iad-01.braze.com. The number and prefix change based on your region (US, EU, AU, etc.). Use exactly this URL when configuring your Coupler.io data flow.

Can I sync data from multiple Braze workspaces?

Yes. Each Braze workspace has its own API key and REST endpoint. Create a separate source connection in Coupler.io for each workspace, then use the Append transformation to combine data from multiple workspaces into a single destination table. This is useful for agencies or businesses that manage multiple brands under separate Braze workspaces.

Why does my analytics data look different from what I see in the Braze dashboard?

Braze's API returns data in UTC, while the dashboard may display data adjusted to your workspace timezone. Attribution windows (how conversions are counted) can also differ. When comparing API data to the dashboard, account for these timezone and attribution differences. See the Data Discrepancies section for more detail.

For a full list of known discrepancy causes, see Common Issues.

Can I use Braze data with AI tools through Coupler.io?

Yes. Coupler.io supports AI destinations including ChatGPT, Claude, Gemini, Cursor, Perplexity, and OpenClaw. You can route campaign performance data or KPI trends directly to these tools for automated analysis, anomaly detection, or content recommendations.

How far back can I pull historical data?

Use the date picker in the source settings to set a start date. Braze's API supports historical analytics data, but very long date ranges (e.g., 2+ years of daily data across many campaigns) can result in slow syncs or rate limit errors. For initial historical loads, consider splitting the range across a few manual runs before switching to incremental daily updates.

For tips on managing large syncs efficiently, see Best Practices.

What permissions does my Braze API key need?

Your API key needs read access to the specific endpoints Coupler.io calls. At minimum:

• /campaigns/list and /campaigns/data_series for campaign data

• /canvas/list and /canvas/data_series for canvas data

• /segments/list and /segments/data_series for segment data

• /events/list and /events/data_series for event data

• /feed/list and /feed/data_series for cards data

• /kpi/new_users/data_series, /kpi/dau/data_series, /kpi/uninstalls/data_series for KPIs

If you get a 403 error on a specific entity, that endpoint permission is likely missing from your key.

See Common Issues — Permission Errors for troubleshooting steps.