Braze
Send user data to Braze for engagement campaigns. Sync user attributes, custom events, purchases, and more from your warehouse to Braze.
Prerequisites
- A Braze account
- A Braze REST API key with the necessary permissions
- Your Braze REST endpoint (cluster URL)
Authentication
Braze uses REST API Key authentication.
- In Braze, go to Settings > API Keys
- Create a new REST API key with the required permissions (users.track, users.delete, etc.)
- Copy the API key
- Paste it into the REST API Key field in SignalSmith
Configuration
| Field | Type | Required | Description |
|---|---|---|---|
| REST Endpoint | Select | Yes | Your Braze REST API endpoint for your cluster. Options include US-01 through US-08 and EU-01, EU-02. |
| App Group ID | Text | No | Braze app group identifier (optional) |
Target Settings
| Field | Type | Required | Description |
|---|---|---|---|
| Object Type | Select | Yes | The type of data to send: User Attributes, Custom Events, Purchases, User Delete, User Alias, User Merge, Subscription Status, Catalog Items, Trigger Campaign, or Trigger Canvas |
| Catalog Name | Text | Conditional | Catalog name (required for Catalog Items) |
| Campaign ID | Text | Conditional | Campaign ID to trigger (required for Trigger Campaign) |
| Canvas ID | Text | Conditional | Canvas ID to trigger (required for Trigger Canvas) |
| Subscription Group ID | Text | Conditional | Subscription group ID (required for Subscription Status) |
Supported Operations
Sync Modes: Upsert, Insert
Audience Sync Modes: Add, Remove, Mirror, Upsert
Features
- Field Mapping: Yes
- Schema Introspection: No
Required Mapping Fields
Required fields depend on the selected Object Type:
| Object Type | Required Fields |
|---|---|
| User Attributes | external_id |
| Custom Events | external_id, name, time |
| Purchases | external_id, product_id, currency, price |
| User Delete | external_id |
| User Alias | external_id, alias_name, alias_label |
| User Merge | identifier_to_merge, identifier_to_keep |
| Subscription Status | external_id, subscription_state |
| Catalog Items | id |
| Trigger Campaign | external_user_id |
| Trigger Canvas | external_user_id |
Default Destination Fields (User Attributes)
external_id, email, first_name, last_name, phone, gender, dob, country, city, language, time_zone, email_subscribe, push_subscribe
Troubleshooting
Authentication failed: invalid API key
Verify your REST API key in Braze Settings > API Keys. Ensure the key has the required permissions for the selected object type.
Incorrect REST endpoint
Each Braze cluster has a different REST endpoint. Select the endpoint that matches your Braze dashboard URL. For example, if your dashboard is at dashboard-01.braze.com, use US-01.
External ID not found
Braze requires an external_id for most operations. Ensure your model includes a column that maps to the user’s external ID in Braze.
Rate limiting
Braze enforces rate limits on API endpoints. SignalSmith batches requests and handles rate limiting automatically.