SMS subscription groups
Subscription Groups are the foundation for sending SMS & MMS through Braze. A Subscription Group is a collection of sending phone numbers (such as short codes, long codes, and/or alphanumeric sender IDs) that are used for a specific type of messaging purpose. For example, if a brand has plans to send both transactional and promotional SMS messaging, two Subscription Groups with separate pools of sending phone numbers will need to be set up within your Braze dashboard.
SMS subscription states
There are two subscription states for SMS users:
unsubscribed. A user’s subscription state is not shared across Subscription Groups, meaning a user can be
subscribed to a transactional Subscription Group but
unsubscribed to a promotional one. For brands, this separation of states ensures that they can continue to send relevant SMS messages to their users.
|Subscribed||User has explicitly confirmed that they want to receive SMS from a specific Subscription Group. A user can be subscribed either by having their subscription state updated through the Braze subscription API or by texting an opt-in keyword response. A user must be subscribed to an SMS Subscription Group in order to receive an SMS.|
|Unsubscribed||User has explicitly opt-ed out of messaging from your SMS Subscription group and the sending-phone numbers inside the Subscription Group. They can unsubscribe by texting an opt-out keyword response or a brand can unsubscribed users through the Braze subscription API. Users unsubscribed from an SMS subscription Group will no longer receive any SMS from sending phone numbers that belong to the Subscription Group.|
How users’ SMS subscription groups get set
- Rest API: User profiles can be programmatically set by the
/subscription/status/setendpoint by using the Braze REST API.
- SDK Integration Users can be added to an email or SMS subscription group using the
addToSubscriptionGroupmethod for Android, iOS, or Web.
- Automatically handled upon user opt-in/opt-out: By users texting a default opt-in or opt-out keyword, Braze automatically sets and updates users’ subscription state.
- User import: Users can be added into email or SMS subscription groups via Import Users. When updating subscription group status, you must have these two columns in your CSV:
subscription_state. Refer to User import for more information.
If you are using the older navigation, this page is called User Import and can be found under Users.
Updated phone numbers and subscription groups
When a phone number is updated on a user profile, the new phone number inherits the subscription group status of the old number.
How to check a user’s SMS subscription group
- User Profile: Individual user profiles can be accessed through the Braze dashboard by selecting User Search from the sidebar. Here, you can look up user profiles by email address, phone number, or external user ID. When inside a user profile, under the Engagement tab, you can view a user’s SMS subscription groups.
- Rest API: Individual user profiles subscription group can be viewed by the List user’s subscription groups endpoint or List user’s subscription group status endpoint by using the Braze REST API.
Sending with a subscription group
To launch an SMS campaign through Braze, a Subscription Group must be selected in the dropdown, as shown in the following image. After it’s selected, an audience filter will be added to your campaign or Canvas automatically, ensuring that only users
subscribed to the selected Subscription Group are in the target audience. To adhere to international telecommunication compliance and guidelines, Braze will never send SMS to users that have not subscribed to the selected Subscription Group.
During your SMS onboarding process, a Braze onboarding manager will set up Subscription Groups for your dashboard account. They will work with you to determine how many Subscription Groups you need and add the appropriate sending phone numbers to your Subscription Groups. Timelines for setting up a Subscription Group will depend on the type of phone numbers you’re adding. For example, short code applications can take anywhere between 8-12 weeks, while long codes can be set up within a day. If you have questions about your Braze dashboard setup, reach out to your Braze representative for support.
Subscription group MMS enablement
In order to send an MMS message, at least one number within your Subscription Group has to be enabled to send MMS. This is indicated by a tag located next to the Subscription Group.