Linking Braze as a source
This source is currently in alpha. The interface and available tables may change.
The Braze connector syncs your Braze data — campaigns, canvases, segments, events, and templates — into the PostHog data warehouse.
Adding a data source
- Go to the sources tab of the data pipeline section in PostHog.
- Click + New source and then click Link next to Braze.
- You need a REST API key and your REST endpoint URL from Braze. In your Braze dashboard, go to Settings → API Keys and create a REST API key. Grant the following endpoint permissions for the data you want to sync:
campaigns.list,canvas.list,segments.list,events.list,templates.email.list, andcontent_blocks.list. Your REST endpoint URL (for examplehttps://rest.iad-01.braze.com) must match your Braze dashboard's region — see Braze's API overview for the full list of endpoints. - Back in PostHog, enter your
REST API keyandREST endpoint URL, then click Next. - Select the tables you want to sync, set the sync method and frequency, then click Import.
Once the syncs are complete, you can start using Braze data in PostHog.
Available tables
| Table | Description | Sync method |
|---|---|---|
campaigns | Campaigns in your Braze account | Full refresh |
canvases | Canvases in your Braze account | Full refresh |
segments | Segments in your Braze account | Full refresh |
events | Custom event names tracked in Braze | Full refresh |
email_templates | Email templates | Incremental |
content_blocks | Content blocks | Incremental |
Incremental tables sync only new or updated records on each run. Full refresh tables reload all data on each sync.
Sync limitations
Only the email templates and content blocks tables support incremental sync, using Braze's server-side modified_after filter. The remaining tables are full refresh only, as Braze does not provide a reliable server-side timestamp filter for them.
Configuration
| Option | Type | Required |
|---|---|---|
REST API key | password | Yes |
REST endpoint URL | text | Yes |
Supported tables
| Table | Description | Sync method | Incremental field | Primary key |
|---|---|---|---|---|
campaigns | A Braze messaging campaign that sends content to users across one or more channels. | Full refresh | — | — |
canvases | A Braze Canvas — a multi-step customer journey across channels and time. | Full refresh | — | — |
segments | A Braze segment — a saved group of users defined by filter criteria. | Full refresh | — | — |
events | The list of custom event names recorded in the Braze workspace. | Full refresh | — | — |
email_templates | A reusable email template stored in Braze. | Incremental, Full refresh | updated_at | — |
content_blocks | A reusable Content Block — a snippet of content shared across Braze messages. | Incremental, Full refresh | last_edited | — |