--- title: Braze API Integration on Truto slug: braze category: Marketing Automation canonical: "https://truto.one/integrations/detail/braze/" --- # Braze API Integration on Truto **Category:** Marketing Automation **Status:** Beta ## Unified APIs ### Unified User Directory API - **Users** — The User object represents a User. ## How it works 1. **Link your customer's Braze account.** Use Truto's frontend SDK; we handle every OAuth and API key flow so you don't need to create the OAuth app. 2. **Authentication is automatic.** Truto refreshes tokens, stores credentials securely, and injects them into every API request. 3. **Call Truto's API to reach Braze.** The Proxy API is a 1-to-1 mapping of the Braze API. 4. **Get a unified response format.** Every response uses a single shape, with cursor-based pagination and data in the `result` field. ## Use cases - **Sync user profiles and attributes into Braze for personalized campaigns** — SaaS companies that manage user data (e.g., subscription status, loyalty tiers, support history) can push enriched user profiles into their customers' Braze instances, enabling marketers to build hyper-targeted segments and personalized messaging without manual CSV imports. - **Suppress marketing for users with open support tickets** — Helpdesk and customer support platforms can sync ticket status as custom attributes on Braze user profiles, letting their customers' marketing teams automatically suppress promotional emails and review requests for users who are actively experiencing issues. - **Power lifecycle marketing with real-time billing and subscription data** — Subscription billing and payment platforms can push plan details, renewal dates, and churn risk scores as user attributes into Braze, enabling their customers to trigger win-back flows, upgrade nudges, and renewal reminders based on live billing state. - **Enable survey and feedback tools to drive retention workflows** — Voice-of-customer and survey platforms can sync NPS scores and response data into Braze user profiles, allowing their customers' CRM teams to segment detractors and promoters and trigger appropriate follow-up journeys automatically. - **Keep loyalty program data in sync for trigger-based engagement** — Loyalty and rewards SaaS products can continuously update point balances and tier levels on Braze user profiles, so their customers' marketers can build real-time congratulatory messages, tier-upgrade notifications, and point expiration reminders. ## What you can build - **One-click Braze user profile sync** — Let your end users connect their Braze account and automatically push enriched user records — including custom attributes like plan type, account status, or engagement scores — directly to Braze user profiles. - **Automated attribute mapping from your data model to Braze** — Provide a configuration UI where your customers map fields from your product's user model to Braze custom attributes, with Truto handling auth, normalization, and delivery. - **Real-time user directory writeback to Braze** — Whenever a user record changes in your platform, automatically propagate that update to the corresponding Braze profile so marketers always act on the freshest data. - **Bulk user upsert for initial backfill and ongoing sync** — Ship a feature that backfills your customers' existing user base into Braze on first connection, then keeps profiles current with incremental syncs — no engineering effort required from your customer. - **Unified user identity resolution across Braze and other tools** — Leverage Truto's Unified User Directory API to maintain a canonical user identity that stays consistent across Braze and other connected platforms your product integrates with. ## FAQs ### How does authentication work for Braze integrations? Braze uses REST API keys scoped to specific workspaces. Your end users generate an API key from their Braze dashboard with the required permissions, and provide their Braze REST endpoint URL (which varies by cluster, e.g., rest.iad-01.braze.com). Truto securely stores these credentials and handles authenticated requests on behalf of your users. ### What is the primary identifier used for users in Braze? Braze strictly enforces `external_id` as the primary key for identified user profiles. Any user sync must map to this field. Truto's Unified User Directory API can be configured to map your canonical user ID to Braze's external_id for consistent identity resolution. ### Are there rate limits on the Braze API? Yes. Braze enforces rate limits that vary by endpoint and customer plan, typically 250,000 requests per hour for the /users/track endpoint. Braze also supports batching up to 75 user objects per request. Truto handles batching and rate limit management so your integration stays within bounds without manual throttling. ### Can I sync custom attributes and arbitrary fields to Braze? Yes. Braze's user profile model is highly extensible — you can push arbitrary key-value pairs as custom attributes. Since the Braze integration is built on request via Truto, the implementation will support mapping custom fields from your data model to Braze custom attributes alongside standard profile fields. ### What Unified APIs does Truto support for Braze today? Braze is currently mapped to Truto's Unified User Directory API, which covers user profile reads and writes. Specific tools and additional API coverage (e.g., event tracking, campaign triggering, catalog sync) are built on request based on your integration requirements. ### Does Braze support reading user data back via API? Yes. Braze provides endpoints to export user profiles by external_id or segment. However, Braze is primarily designed as a data ingestion platform — most integration patterns involve pushing data into Braze rather than pulling it out. Truto can support both directions depending on your use case.