# Receive SMS notifications
This how-to covers how to make use of the SMS Action Type to receive text message notifications when someone interacts with one of your apps.
# Create the action
Follow the steps below to create an action for sending SMS notifications.
# Step 1: Choose a workspace
Start by making sure you're in the desired workspace. Hover over the menu bar dropdown to choose.

# Step 2: Open the new action dialog
Select the Actions tab within the workspace view and click the + New Action button. This will launch a modal for creating new actions.

# Step 3: Select the SMS action type
From the action creation model, select SMS from the Action type dropdown list.

# Step 4: Configure the action
Enter a name, description (optional) and desired phone number. You can also customize a text Message format by providing your own Jinja2 template (opens new window) that follows the Routegy templating guide. Phone Number can be set to a static value (e.g. 555-555-5555) or to any variable available in the templating context. For instance, if your app pattern includes an element named phone_number
nested in a fieldset named contact_info
, you can just enter contact_info.phone_number
, and Routegy will send a text message to a phone number collected by your app from a user.
TIP
If you don't provide a country code, it will default to 1. See wikipedia (opens new window) for more details.
Once the action is configured, click on + Create action to complete the process.

# Attach the action to an app
Follow the steps below to attach the SMS action created above to one or more apps.
# Step 1: Choose an app
Select the Apps tab within the workspace view and select the app you wish to send SMS notifications.

# Step 2: Open the app editor
From the app model, click on the Edit button.

# Step 3: Add your new action
From the app edit model, type in the name of your SMS action in Actions list. The name will autocomplete as you type.

# Step 4: Save your changes
Click on the Save changes button and you're done!

# Step 5: Wait for app interactions
Now that your app is configured, you just wait until someone interacts with it. Once they do, you'll receive an SMS that looks something like this.
