Plumber user guide
Click here if you can't view this page properlyGo to appSupport
  • 👩‍🔧Plumber
  • Login to Plumber
  • 💼Popular Workflows
    • 🔀ALL WORKFLOWS
    • 🔔Notifications for FormSG
    • 📧Email customised acknowledgements to respondent
    • 🔥Get updated on urgent requests w/ Telegram
    • ☎️Keep mailing lists updated
    • ✔️Attendance taking
    • 🤝Dynamic response based on respondent selections
  • 📖User guides
    • Executions page
    • Pipe settings
    • Triggers
      • 📃FormSG
      • ⚙️Webhooks
      • 🕐Scheduler
    • Actions
      • 🔷Tiles
      • 📊M365 Excel (.gov.sg Agencies only)
      • ✉️LetterSG
      • 📪Email by Postman
      • ☎️SMS by Postman
      • 🗂️Vault workspace
      • #️⃣Slack
      • 💵PaySG
      • ☎️Telegram
      • 💼Toolbox
      • 🌉Custom API
  • Help!!!
    • ⁉️FAQ
    • 🧑Contact us
  • Legal
    • Terms of Use
    • Government Agency Privacy Statement
Powered by GitBook
On this page
  • Available Actions
  • Send SMS
  • Step A: Create a Postman SMS campaign and API key
  • Step B: Configure Plumber
  • Migrating From Twilio

Was this helpful?

  1. User guides
  2. Actions

SMS by Postman

This page explains the steps you need to follow to set up SMS by Postman as an action for your pipe.

PreviousEmail by PostmanNextVault workspace

Last updated 1 year ago

Was this helpful?

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

  1. After creating the campaign, take note of its campaign id:

    1. 52.76.216.61

    2. 52.74.55.209

    3. 18.139.42.66

Step B: Configure Plumber

  1. Choose 'SMS by Postman' as the app.

  2. Choose 'Send SMS' as the action

  3. Click 'Continue' to connect your Postman SMS campaign to Plumber

  4. In the 'Choose connection' drop down, select 'Add new connection'

    1. In the 'Label' field, enter a description for your campaign

    2. In the "Campaign ID" field, paste your campaign ID (you obtained this in step A2 above)

    3. In the 'API key' field, enter the API key for your campaign (you generated this in Step A4 above)

    4. Click 'Submit' to finish connecting your Postman SMS campaign to Plumber

  5. Click 'Continue' to proceed to set up your action.

  6. In the 'Recipient' field, enter the SMS recipient's phone number with country code.

  7. In the 'Message' field, enter the message you wish to send to the recipient.

  8. Click 'Continue' to proceed to test your action

  9. 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"

Follow to create an SMS campaign. For campaign content, enter {{body}}. It should look like this:

Whitelist Plumber's IP addresses in your campaign by following this . You should whitelist the 3 IPs below:

Generate API keys for your SMS campaign by following this . You will need this when setting up Plumber later.

5. Follow the instructions in the to configure this new "Send SMS" action.

📖
☎️
Postman's guide
guide
guide
above section
Send SMS
Sample SMS from an OGP user. Plumber will send SMSes with your agency name in the header.