Collecting user opt-ins

The following article lists some common SMS opt-in methods.

Option 1: Ask users to text your short or long code

Ask users to text “START”, “UNSTOP”, “YES”, or a custom opt-in keyword to your number to automatically add them to your subscription group. On your website, mobile app, or even advertising, you can request users do this to opt-in, and you can offer an incentive if it’s helpful.

Option 2: Users opt-in via in-app message

To allow users to opt into SMS from an in-app message, use the phone number capture form provided by Braze to create a branded form that allows you to collect phone numbers and grow your SMS list.

Braze recommends that you also use the SMS double opt-in feature. This feature automatically works with the in-app message phone number capture form, prompting users to confirm their intent after submitting their phone number via the form.

Option 3: Sign-up flow

When a new user signs up or registers on the website or app, ask for their phone number and email. Include a checkbox to receive promotional emails and SMS.

After the user signs up, do the following:

1. Use the /subscription/status/set endpoint to create the user and save their attributes.

1
2
3
4
5
6
7
8
9
10
POST 'https://rest.iad-03.braze.com/subscription/status/set' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR-REST-API-KEY' \
--data-raw '{
  "subscription_group_id": "xyz-abcd-1234567",
  "subscription_state": "subscribed",
  "external_id": "external_identifier",
  "phone": "+12223334444"
}
'

2. Use the /users/track endpoint to subscribe the user to SMS.

1
2
3
4
5
6
7
8
POST `https://rest.aid-03.braze.com/users/track` \
--header `Content-Type: application/json` \
--header `Authorization: Bearer YOUR-REST-API-KEY` \
--data-raw `{
"attributes" : [
Unknown macro: { "external_id" }
]
}