☎️SMS by Postman
This page explains the steps you need to follow to set up SMS by Postman as an action for your pipe.
Available Actions
Send SMS
Note that in accordance with the SG Government SMS policy, SMSes will be sent under the gov.sg sender ID, with a fixed header and footer, like so:
To add this action to your pipe, follow these 2 steps:
Step A: Create a Postman SMS campaign and API key
Follow Postman's guide to create an SMS campaign. For campaign content, enter
{{body}}
. It should look like this:After creating the campaign, take note of its campaign id:
Whitelist Plumber's IP addresses in your campaign by following this guide. You should whitelist the 3 IPs below:
52.76.216.61
52.74.55.209
18.139.42.66
Generate API keys for your SMS campaign by following this guide. You will need this when setting up Plumber later.
Step B: Configure Plumber
Choose 'SMS by Postman' as the app.
Choose 'Send SMS' as the action
Click 'Continue' to connect your Postman SMS campaign to Plumber
In the 'Choose connection' drop down, select 'Add new connection'
In the 'Label' field, enter a description for your campaign
In the "Campaign ID" field, paste your campaign ID (you obtained this in step A2 above)
In the 'API key' field, enter the API key for your campaign (you generated this in Step A4 above)
Click 'Submit' to finish connecting your Postman SMS campaign to Plumber
Click 'Continue' to proceed to set up your action.
In the 'Recipient' field, enter the SMS recipient's phone number with country code.
In the 'Message' field, enter the message you wish to send to the recipient.
Click 'Continue' to proceed to test your action
Click on 'Test Step' and verify that the SMS has been sent to the recipient's phone.
Migrating From Twilio
To comply with government policy, Twilio will be disabled in Plumber pipes for most public servants starting from 28 June 2024. SMS by Postman is Twilio's replacement. Note: Unlike Twilio app, you are not allowed to configure the "From Number" in SMS by Postman.
1. Navigate to your pipe.
2. Unpublish the pipe.
NOTE: Unpublishing will stop the pipe from processing any new triggers until you publish it again. If you are using a FormSG trigger, we recommend that you close the FormSG first.
3. Expand your Twilio step, and ensure that "choose app & event" section is expanded
4. Under "Choose an app", select "SMS by Postman". Then under "Choose an event", select "Send SMS"
5. Follow the instructions in the above section to configure this new "Send SMS" action.
Last updated