Connect your Braze account with Lexer

You can connect your Braze account with Lexer, this will permit Lexer to import your contacts from Braze as enriched Profiles as well as create and update contact email lists.

Benefits of a Braze integration

  • Import your contacts as enriched Profiles
  • Send customer email lists for marketing campaigns

How do I integrate my account?

Select the Braze tile, and click Integrate Braze, then enter your Braze application details and hit Save Integration.

For information on how to obtain your API key, read here

This integration works by providing Lexer with your existing API token and secrets, and allowing Lexer to make these imports on your behalf.

What is a Braze activation?

The Braze activation allows you to securely send your customer data from Lexer to Braze, and update or create your Braze segments with custom attributes.

The activation permits you to send and update the following custom attributes in Braze.

External ID

Non-Braze user ID.


Bio included on user’s account/profile.


Country provided in a user’s account.

Date of birth

Date of birth provided in a user’s account.


Email address provided in a user’s account.

Email subscribe

Identifier for whether or not the user has subscribed to emails

First name

First name provided in a user’s account.


Gender provided in a user’s account.

Home city

Home City provided in a user’s account.

Image URL

Image URL included in a piece of content.

Last name

Last name provided on a user’s account.


Phone number provided in a user’s account.

Custom string

For storing user input, such as a favorite brand, phone number, or a last search string within your application.

Custom boolean

For storing subscription statuses, and other simple binary data about your users. This allows you to find users that have set to a true/false value as well as those with no record of that attribute recorded yet.

Custom float

AKA: standard integers and decimals. Examples include recording shoe size, waist size, number of times a user has viewed a certain product feature, or category.

Custom integer

AKA: incrementing integer custom attributes. Useful for storing the number of times a given action or event has occurred without counting against your data cap.

Custom array

Array attributes are good for storing related lists of information about your users. For example, storing the last 100 pieces of content a user watched within an array would allow specific interest segmentation.

Custom date

For storing the last time a specific action was taken, so you can offer content specific re-engagement messaging to your users. Date filters using relative dates, such as “more than 1 day ago”, or “less than 2 days ago”.

Braze terminology

Identity segment

A group of customers identified by selected attributes, like a Segment in Lexer Segment

Custom attribute

An identifier tailored to your needs - this could be products, or stores, for example

How do I activate to Braze?

You can send Profiles from Lexer to Braze, to update custom Attributes within Braze.

Before you get started, make sure you’ve done the following:

  • Integrated your Braze account with Lexer
  • Created an activation to Braze in Lexer Activate (contact Lexer Support ([email protected]) if not)
  • Built your Segments in Lexer Segment

If you need a refresher on creating Segments, head here.

Sending your Segment to Braze

When you’re ready to send your Segment to Braze, navigate to Lexer Activate.

  1. Click ACTIVATE NEW AUDIENCE to get started
  2. Select the appropriate Braze activation for this campaign
  3. Add your Segment
  4. Update the audience name, this will become your attribute value in Braze
  5. This is the CUSTOM ATTRIBUTE we’ll be updating in Braze - contact Lexer Support ([email protected]) to update
  6. Check the appropriate list action - in most cases you’ll just want to maintain your list
  7. Agree to terms, and click SEND AUDIENCE

Set and forget - auto-updating audiences

Lexer Activate permits you to automatically update your Profiles within Braze. With this selected, Lexer will add or remove attributes in Braze, as customers enter and leave your Segment.

Okay I’ve sent my audience, what next?

The moment your activation has been confirmed as sent in Activate, you’ll see records begin to update in Braze. Your Profiles won’t be fully updated in Braze until after you receive a confirmation email from Lexer, advising your activation has completed.

When everything has arrived in Braze, you’ll see your audience name from Activate is now a value in your lexer_audience custom attribute. Braze has a limit of 100 values per attribute, so be sure to keep on top of this. This article from Braze talks in detail about custom attributes. Lexer populates an array attribute.

Create your Braze segment

Within Braze you can create segments of your customers, just like you can in Lexer. When you send a Segment to Braze, you are appending that audience name to the custom attribute lexer_audience within Braze.

A segment within Braze can be targeted in an on-going basis, so for example “Abandoned Cart Shoppers”. Or on more bespoke basis, “Has engaged with Summer Campaign”.

When making a segment in Braze you call upon your custom attributes to build it. It’s here that you can select your Lexer made custom attribute values.

For more information on building segments in Braze, read their article Creating a segment.

Did this page help you?