# FormSG and SMS integration (For gov.sg users)

{% 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.

<figure><img src="/files/QOOE7yIrkTUPxu8lbePG" alt=""><figcaption></figcaption></figure>

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&#x20;
3.

{% endtab %}
{% endtabs %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://guide.plumber.gov.sg/all-workflows/formsg-and-sms-integration-for-gov.sg-users.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.