Skip to content
Check out our new developer portal and join the Braze developer community!

Braze API Guide

Braze provides a high-performance REST API to allow you to track users, send messages, export data, and more. This page lists available Braze API endpoints and their uses.

Select endpoint type to narrow the glossary:
Endpoint
Description

Delete multiple items in your catalog.

Edit multiple items in your catalog.

Create multiple items in your catalog.

Delete an item in a catalog.

List a catalog item and its details.

Return multiple catalog items and their content.

Edit an item in a catalog.

Create an item in a catalog.

Delete a catalog.

List the catalogs in an app group.

Create a catalog.

Pull a list of email addresses that have "hard bounced" your email messages within a certain time frame.

Return emails that have unsubscribed during the time period from start_date to end_date.

Unsubscribe a user from email and mark them as hard bounced.

Set the email subscription state for your users.

Remove email addresses from your Braze bounce list.

Remove email addresses from your Braze spam list.

Retrieve a daily series of various stats for a campaign over time.

Retrieve relevant information on a specified campaign.

Export a list of campaigns, each of which will include its name, campaign API identifier, whether it is an API campaign, and tags associated with the campaign.

Retrieve a daily series of various stats for a tracked send_id.

Export time series data for a Canvas.

Export rollups of time series data for a Canvas, providing a concise summary of a Canvas' results.

Export metadata about a Canvas, such as the name, time created, current status, and more.

Export a list of Canvases, including the name, Canvas API identifier and associated tags.

Export a list of custom events that have been recorded for your app.

Retrieve a series of the number of occurrences of a custom event in your app over a designated time period.

Retrieve a daily series of the total number of new users on each date.

Retrieve a daily series of the total number of unique active users on each date.

Retrieve a daily series of the total number of unique active users over a 30-day rolling window.

Retrieve a daily series of the total number of uninstalls on each date.

Retrieve a daily series of engagement stats for a card over time.

Retrieve relevant information on a card.

Export a list of News Feed cards, each of which will include its name and card API identifier.

Return a paginated lists of product IDs.

Export a list of segments, each of which will include its name, Segment API identifier, and whether it has analytics tracking enabled.

Retrieve a daily series of the estimated size of a segment over time.

Retrieve relevant information on a segment.

Retrieve a series of the number of sessions for your app over a designated time period.

Export all users within a Global Control Group.

Export data from any user profile by specifying a user identifier.

Export all the users within a segment.

Return a JSON list of information about scheduled campaigns and entry Canvases between now and a designated end_time specified in the request.

Cancel a message that you previously scheduled before it has been sent.

Cancel a Canvas message that you previously scheduled via API-triggered before it has been sent.

Cancel API-triggered campaign messages that you previously scheduled before it has been sent.

Schedule a campaign, Canvas, or other message to be sent at a designated time (up to 90 days in the future).

Send dashboard created campaign messages (up to 90 days in advance) via API-triggered delivery.

Schedule Canvas messages (up to 90 days in advance) via API-triggered delivery.

Update scheduled messages. This endpoint accepts updates to either the schedule or messages parameter or both.

Update scheduled API-triggered campaigns created in the dashboard.

Update scheduled API-triggered Canvases that were created in the dashboard.

Create send IDs that can be used to send messages and track message performance programmatically, without campaign creation for each send.

Send immediate, ad-hoc messages to designated users via the Braze API.

Send immediate, ad-hoc transactional messages to a designated user.

Send immediate, ad-hoc messages to designated users via API-triggered delivery. - Send Messages

Send Canvas messages via API-Triggered delivery. - Send Messages

List available preference centers.

View the details for your preference centers, including when it was created and updated.

Create a preference center to allow users to manage their notification preferences for email campaigns.

Pull a list of phone numbers that have been deemed "invalid" within a certain time frame.

Remove "invalid" phone numbers from Braze's invalid list. This can be used to re-validate phone numbers after they have been marked as invalid.

Get the subscription state of a user in a subscription group.

List and get the subscription groups of a certain user.

Batch update the subscription state of up to 50 users on the Braze dashboard.

Batch update the subscription state of up to 50 users on the Braze dashboard.

List your existing Content Blocks information.

Call information for your existing email Content Block.

Create an email Content Block.

Update an email Content Block.

Get a list of available email templates in your Braze account.

Get information on your email templates.

Create email templates on the Braze dashboard.

Update email templates on the Braze dashboard.

Remove your users’ old deprecated external IDs.

Rename your users’ external IDs.

Add new user aliases for existing identified users, or to create new unidentified users.

Delete any user profile by specifying a known user identifier.

Identify an unidentified (alias-only) user.

Record custom events, purchases, and update user profile attributes.

Permanently delete an existing dashboard user.

Look up an existing dashboard user account by specifying their email.

Look up an existing dashboard user account by specifying their email.

Create a new dashboard user account by specifying email, given and family names, permissions (for setting permissions at the company, app group, and team level).

Update an existing dashboard user account by specifying email, given and family names, permissions (for setting permissions at the company, app group, and team level).
WAS THIS PAGE HELPFUL?
New Stuff!