Creating a push message

Push notifications are wonderful for time-sensitive calls to action, as well as re-engaging users who haven’t come into the app in a while.

Successful push campaigns drive the user directly to content and demonstrate the value of your app.

To see examples of push notifications, check out our Case Studies.

Step 1: Create a new push campaign

Create new push campaign

Navigate to the Campaigns page and create a new push campaign. Click Create Campaign and select Push Notification. Or, if you want to include multiple channels in addition to Push, select Multichannel Campaign.

Step 2a: Name your campaign, choose messaging types, and compose your message

Give your campaign a name and select the platform you want to target. For multichannel campaigns, click Add Messaging Channel to add additional push platforms.

Select push platform

Select notification type

For iOS or Android, select your notification type:

If you want to include images in your push campaign, refer to the following guides on creating a rich notification for iOS or Android.

Now it’s time to write your push message! Start typing in the message box and watch a preview appear in the preview box to the left. Don’t forget to use Liquid when writing your push messages to make them personalized and targeted.

Additional push customization steps


Add copy in multiple languages using the Add Languages button. Insert Liquid into your message to set custom messages and fields in specific languages based on a customer’s language preferences. Check out example use cases in our Liquid Use Case Library.

On click behavior

Specify what happens when a user clicks the body of a push notification with On Click Behavior. For example, you can prompt customers to open your application, redirect customers to a specified Web URL, or even open a specific page of your application with a deep link.

Here, you can also set up button prompts within your push notification, such as:

  • Yes/No
  • Confirm/Cancel
  • More

Step 2b: Preview and test your message

Test push message

Testing is arguably one of the most critical steps. After you finish composing your perfect push message, test it before sending it out. Select the Test tab and use Preview Message as User to get a sense of how your message may view on mobile. Use Send Test to send yourself a test push and ensure that your message displays properly.

Step 3: Schedule your push messaging campaign

Choose between sending your campaign at a scheduled time, after users complete an action, or via an API request.


Use Scheduled Delivery to specify the time you want your campaign to send, either immediately or at a future time (you can also consider a user’s local time in your scheduling).

Not sure what the best time is to send your campaign? Use Intelligent Timing to send your campaign when a user is most likely to engage. Braze makes this calculation based on a statistical analysis of the user’s interactions with your app.

Messages can also be configured to recur on a daily, weekly (optionally on specific days), or monthly basis.

Use Action-Based Delivery to specify the time a message will send after a user takes a particular action. Configure messages to send immediately or after a delay (you can also consider a user’s local time in your scheduling).

Use API-Triggered Delivery for more advanced transactional use cases.

Step 4: Target users

On the Target Users step of the campaign setup, choose the target audience for your campaign.

Targeting Options

Under the Targeting Options section, you’ll find a few options for who you can send your campaign to:

  1. Members of a previously created segment. To do this, select one segment from the dropdown under Target Users By Segment.

  2. Users that fall into multiple previously created segments. To do this, add multiple segments from the dropdown under Target Users By Segment. The resulting target audience will be users in the first segment and the second segment and the third segment, etc.

  3. Users of one or more previously created segments that also fall under additional filters. After first selecting your segments, further refine your audience under the Additional Filters section. This is demonstrated in the screenshot below, which targets users that are in the 10 Unread Messages segment and are in the Active Users segment, and made a purchase less than 30 days ago.

  4. Users that fall under a series of filters (and are not defined by pre-existing segments). This means you do not need to target a campaign at a pre-existing segment. Instead, make an ad hoc audience during campaign creation by only using the additional filters and not selecting any segments under Target Users By Segment. This will allow you to skip segment creation when sending campaigns to one-off audiences.

Detailed audience statistics for the channels targeted by your campaign are available in the footer. To see what percentage of your user base is being targeted and the Lifetime Value for this segment, click Show Additional Stats.

Reachable Users Footer

Keep in mind that exact segment membership is always calculated right before the message is sent.

Multichannel campaigns with push and email

For multichannel campaigns targeting both push and email channels, you may want to limit your campaign so that only the users who are explicitly opted in will receive the message (excluding subscribed or unsubscribed users). For example, say you have three users of different opt-in status:

  • User A is subscribed to email and is push enabled. This user doesn’t receive the email but will receive the push.
  • User B is opted-in to email but is not push enabled. This user will receive the email but doesn’t receive the push.
  • User C is opted-in to email and is push enabled. This user will receive both the email and the push.

To do so, under Audience Summary, select to send this campaign to “opted-in users only”. This option will ensure that only opted-in users will receive your email, and Braze will only send your push to users who are push enabled by default.

Step 5: Choose conversion events

Braze allows you to track whether users perform specific actions (Conversion Events) after receiving a campaign. You can specify any of the following actions as a “Conversion Event”:

  • Opens App
  • Makes Purchase
    • This can be a generic purchase or a specific item
  • Performs specific custom event

You have the option of allowing a conversion event within a time frame that is relevant for your campaign. The conversion window for a conversion event can range from 5 minutes to 30 days. The event will count as a conversion if it takes place during the specified time.

Conversion Event

Step 6: Review and deploy

The final page will give you a summary of the campaign you’ve just designed. Clicking Launch Campaign will enable it to send. Confirm all the relevant details and watch the data roll in!

Confirmation Page

Results data

Braze will show you the number of messages sent and opened over time for each push campaign you deploy, as shown below:


For push notifications, you’ll be able to view statistics for the number of messages sent, delivered, bounced, opened, and directly opened.

New Stuff!