Braze Endpoints

Number of APIs: 62

Braze API Overview

Braze provides a high performance REST API to allow you to track users, send messages, export data, and more.

A REST API is a way to programmatically transfer information over the web using a predefined schema. Braze has created many different endpoints with specific requirements that will perform various actions and/or return various data. API access is done using HTTPS web requests to your company's REST API endpoint (this will correspond to your Dashboard URL as shown in the table below).

Customers using Braze's EU database should use https://rest.fra-01.braze.eu/. For more information on REST API endpoints for customers using Braze's EU database see our EU/US Implementation Differences documentation.

Braze Instances

Using Braze's Qodex Collection

If you have a Qodex account (MacOS, Windows, and Linux versions can be downloaded from their website located here), you can go to our Qodex documentation and click the orange Run in Qodex button in the top, right corner. This will allow you to create an environment, as well as edit the available POST and GET requests to suit your own needs.

Setting Up Your Qodex Environment

The Braze Qodex Collection uses a templating variable, {{instance_url}}, to substitute the REST API URL of your Braze instance into the pre-built requests. Rather than having to manually edit all requests in the Collection, you can set up this variable in your Qodex environment. To do so, please follow the steps below:

1. Click on the gear icon in the top right corner of the Qodex app.
2. Select Manage Environments to open a modal window which displays your active environments.
3. In the bottom right corner of the modal window, click Add to create a new environment.
4. Give this environment a name (e.g. Braze API Requests) and add keys for instance_url and api_key with values corresponding to your Braze instance and Braze REST API Key, as pictured below.

As of April, 2020 Braze has changed how we read App Group API keys. Instead of passing them in the request body or through url parameters, we now read the App Group Restapi_key through the HTTP Authorization header. API keys not passed through the HTTP Authorization Header will coninue to work until they have been sunset.

Using the Pre-Built Requests from the Collection

Once you have configured your environment. You can use any of the pre-built requests in the collection as a template for building new API requests. To start using one of the pre-built requests, simply click on it within the 'Collections' menu on the left side of Qodex. This will open the request as a new tab in the main window of the Qodex app.

In general, there are two types of requests that Braze's API endpoints accept - GET and POST. Depending on which HTTP method the endpoint uses, you'll need to edit the pre-built request differently.

Edit a POST Request

When editing a POST request, you'll need to open the request and navigate to the Body section in the request editor. For readability, select the raw radio button to format the JSON request body.

Edit a GET Request

When editing a GET request, you will need to edit the parameters passed in the request URL. To edit these easily, select the Params button next to the URL bar and edit the key-value pairs in the fields that will appear below the URL bar.

Send Your Request

Once your API request is ready to send, click on the 'Send' button next to the URL bar. The request will be sent and the response data will be populated in a section underneath the request editor. From here, you can view the raw data returned from Braze's API, see the HTTP response code, see how long the request took to process, and view header information.

1. Subscription Groups-Email - List User's Subscription Group - Email GET https://{{instance_url}}/subscription/user/status?external_id={{external_id}}&email=example@braze.com&limit=100&offset=1

2. Subscription Groups-SMS - List User's Subscription Group Status - SMS GET https://{{instance_url}}/subscription/status/get?subscription_group_id={{subscription_group_id}}&external_id={{external_identifier}}&phone=+11112223333

3. Templates-Content Blocks - Create Content Block POST https://{{instance_url}}/content_blocks/create

4. Subscription Groups-SMS - List User's Subscription Group - SMS GET https://{{instance_url}}/subscription/user/status?external_id={{external_id}}&limit=100&offset=1&phone=+11112223333

5. Templates-Content Blocks - List Available Content Blocks GET https://{{instance_url}}/content_blocks/list?modified_after=2020-01-01T01:01:01.000000&modified_before=2020-02-01T01:01:01.000000&limit=100&offset=1

6. Templates-Content Blocks - See Content Block Information GET https://{{instance_url}}/content_blocks/info?content_block_id={{content_block_id}}&include_inclusion_data=No

7. Templates-Email Templates - List Available Email Templates GET https://{{instance_url}}/templates/email/list?modified_after=2020-01-01T01:01:01.000000&modified_before=2020-02-01T01:01:01.000000&limit=1&offset=0

8. Templates-Email Templates - See Email Template Information GET https://{{instance_url}}/templates/email/info?email_template_id={{email_template_id}}

9. Templates-Email Templates - Create Email Template POST https://{{instance_url}}/templates/email/create

10. Templates-Email Templates - Update Email Template POST https://rest.iad-01.braze.com/templates/email/update