Managing Braze users

Learn how to manage users in your company account, including adding, suspending, and deleting users.

Adding Braze users

You must have administrator permissions to add users to your Braze account.

To add a new user:

1. Go to Settings > Company Users.
2. Click + Add New User.
3. Enter their information as prompted, including their email, department, and user role.

4. For users that aren’t administrators, select the company-level and workspace-level permissions you want this user to have.

Email address requirements

Every email address used in an instance must be unique. This means that if you try to add an email address that’s already associated with a user who had or still has access to a company workspace in that instance, you’ll see an error message.

If your team uses Gmail and you’re experiencing issues adding an email address, you can create an alias by adding a plus sign (+) like “+1” or “+test” to the email address. For example, [email protected] can have an alias of [email protected]. Emails to [email protected] will still be delivered to [email protected], but the alias will be recognized as a unique email address.

Can I change my Braze account’s email address?

For security reasons, users cannot change the email address associate with their Braze account. If a user wants to update their email address, an administrator should create a new account for them with their preferred email address.

Suspending Braze users

Suspending a user puts their account into an inactive state, where the user can no longer log in, but the data associated with their account is preserved. Only administrators can suspend or un-suspend Braze users.

To suspend a user, go to Settings > Company Users, find their username and select Suspend.

Administrators can also suspend a user by selecting their name from the list and clicking Suspend user in the footer.

Assigning user access and responsibilities

You can use team, permission sets, and user roles to manage dashboard user access and responsibilities within Braze. Each feature encompasses a different collection of permissions and access-controls.

Key differences

At a high level, each feature has a different scope:

• Permission sets control what dashboard users can do across all workspaces.
• Roles control what dashboard users can do in specific workspaces.
• Teams control the audiences that dashboard users can message.

Feature	What you can do	Scope of access
Permission sets	Bundle permissions related to specific subject areas or actions (such as for “Developers” and “Marketers”), then apply them to dashboard users who need the same permissions across different workspaces.	Company wide
Roles	Bundle individual custom permissions and workspace-access controls into predefined roles (such as “Marketer - Fashion Brands” and “Marketer - Skincare Brands”), then assign a role to dashboard users to directly grant them the associated workspace access and permissions. Users with this level of access are typically managers in more tightly controlled environments or regular dashboard users.	Specific workspaces
Teams	Limit dashboard user access to resources based on the audience (such as customer base location, language, and custom attributes). Users with this level of access typically are responsible for a specific scope within the brand that they’re working on, such as building language-specific content for a multilingual brand.	Specific dashboard

Deleting Braze users

To delete a user, go to Settings > Company Users, find their username and select Delete user.

After a user is deleted, Braze does not keep any of the following account data:

• Any attributes that the user had
• Email address
• Phone number
• External user ID
• Gender
• Country
• Language
• Other similar data

Braze will keep the following account data:

• Custom attributes or test data associated with their account
• Campaigns or Canvases they created (but the user’s name won’t appear in them, such as appearing in the Last edited by column)

Troubleshooting

“Email is already taken” when trying to add a user

If you try to add a new user and receive an error saying the email is already taken, but can’t find them in your user list, that user most likely exists within a different instance of the same Braze dashboard cluster.

To create this new user, you can do either of the following:

1. Delete the user from the other instance before you can create them in the new one, or
2. Create the user with a different email string (such as [email protected]) or another email alias.

If you don’t receive the message activation on your inbox when using [email protected], confirm with your IT team that you can accept messages from that kind of email address. Some administrators filter messages sent to email addresses with a +.