> For the complete documentation index, see [llms.txt](https://guide.plumber.gov.sg/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://guide.plumber.gov.sg/all-workflows/formsg-and-sms-integration-for-gov.sg-users.md).
# FormSG and SMS integration (For gov.sg users)
Plumber offers SMS integration, allowing government staffs to send automated SMS notifications to form respondents. This helps improve communication and reduce response times, streamlining operations.
{% hint style="success" %}
**Why you need this**
* This allows agencies to send automated SMS notifications to form respondents
* Deliver better outcomes for the respondents
{% endhint %}
## Sending SMS to respondent or users with Plumber
Before you get started, make sure you've signed into [FormSG](https://www.form.gov.sg) and have an API created on postman.gov.sg. For more info how to retrieve API key for Postman, click [here](https://guide.plumber.gov.sg/user-guides/actions/sms-by-postman#step-a-create-a-postman-sms-campaign-and-api-key).
{% hint style="warning" %}
From 1st July 2025, SMS services on Postman will require payment. To learn more about pricing and arrangements, please contact your agency's Point of Contact (PIC). You can find your PIC's details by logging into postman.gov.sg
{% endhint %}
{% tabs %}
{% tab title="1. FormSG" %}
## Connect the form you wish to receive notifications for
1. After logging into Plumber.gov.sg
2. Click "Template" on the left or "Use a template" on the homepage
3. Click "Send a copy of form response"
4. Click "Use template" on the top right
5. Click "New form response"
6. Click "Connect" at the right
7. Under "Choose connection", click the dropdown
8. Click "+ Add new form"
9. Under "Form URL", paste the form link that you wish to connect to
10. Under "Form Secret Key", paste the form's secret key
11. Click "Connect"
12. A message "Your form is connected successfully." will be shown
13. Click "Save and continue"
14. Under "1. New form response", a green dot will appear as an indication that the form has been connected successfully.
15. Click "Check step"
16. You're done with setting up the FormSG integration!
You're done with setting up the FormSG integration! Next, setting up [Twilio integration](#send-sms-with-twilio)
{% endtab %}
{% tab title="2. Postman SMS" %}
1. Delete the step by hovering your mouse over to the right hand side of the action
2. Click on the trash icon
3.
{% endtab %}
{% endtabs %}
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.
Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:
```
GET https://guide.plumber.gov.sg/all-workflows/formsg-and-sms-integration-for-gov.sg-users.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
