# About Postman v1 (Postman Legacy)

## Postman v1 (Postman Legacy)

{% hint style="info" %}
We have moved! Access Postman v1 (Postman legacy) at <https://legacy.postman.gov.sg/>.<br>

Please note that Postman v2, a different product, is now hosted at [https://postman.gov.sg/](https://legacy.postman.gov.sg/).

For more information regarding Postman v2, do check our guide at <https://postman-v2.guides.gov.sg/>
{% endhint %}

Postman is a mass messaging tool for the Singapore Government. These messages can be sent via our web app directly (see [campaign guide](https://guide.postman.gov.sg/campaign-guide/before-you-start)) or via sms/email API integration (see [sms API guide](https://api-docs.postman.gov.sg/)/[emailAPI guide](https://postman-v1.guides.gov.sg/email-api-guide/overview)).

We've sent out more than 100 million messages from over 90 agencies. These include quarantine orders, COVID-19 test results, and employer notices.

Start using Postman by logging in with your `@agency.gov.sg` email address!

### Should I be using Postman v1/Postman v2?

<table><thead><tr><th width="171">Description</th><th>Postman v1 (Postman Legacy)</th><th>Postman v2</th></tr></thead><tbody><tr><td>URL (Updated: 1 Apr 2024)</td><td><a href="https://legacy.postman.gov.sg/">https://legacy.postman.gov.sg/</a></td><td><a href="https://legacy.postman.gov.sg/">https://postman.gov.sg/</a></td></tr><tr><td>Guides</td><td><a href="https://postman-v1.guides.gov.sg/">https://postman-v1.guides.gov.sg/</a></td><td><a href="https://postman-v2.guides.gov.sg/">https://postman-v2.guides.gov.sg/</a></td></tr><tr><td>What does each Postman product support</td><td><ul><li>Emails via the admin portal (Postman v1 email UI)</li><li>Email API, only available for <strong>existing email API users.</strong></li><li><p>Postman v1 SMS users that will <strong>not be included</strong> in BTN</p><ul><li>Please continue using Postman v1 to send out your SMSes</li></ul></li></ul></td><td><ul><li><p>Postman v2 SMS for agencies <strong>included</strong> in BTN, including</p><ul><li>Postman v2 SMS - API</li><li>Postman v2 SMS - Admin Portal (UI)</li><li>Postman v2 SMS - SFTP</li></ul></li></ul></td></tr><tr><td>Am I affected by BTN?</td><td><p>The following organisations <strong>will not be affected</strong> by BTN</p><ul><li>Public healthcare institutions</li><li>Exceptions that have been cleared by the BTN and SNDGO team. <br><br>If you are unsure whether or not you are affected by BTN, please <a href="https://form.gov.sg/657025a2d2bd350012c82eb0">contact us</a>. </li></ul></td><td>All agencies affected by BTN have already been contacted by the BTN team</td></tr></tbody></table>

## What can Postman Web App do?

* **Easily customize messages to reach a wide audience**: Create a message template, upload a file containing customization parameters, and we will handle the rest for you.
* **Mass send emails**: Just click `Send campaign` and Postman will send those messages out to your intended audience via email.
* **Mass send SMSes**: Enter your Twilio credentials under `Settings`, and Postman will send those messages via SMS. No integration with Twilio is needed.
* **View stats**: Keep track of your campaign's progress as it is sending and check back when it is completed.
* **Scheduled sending**: Create your campaign but send it out at a later **time**.

## What can Postman email API do?

We provide a **modern, cost-effective, and compliant PaaS** for government agencies to send programmatic emails and messages. Head over to the [email API guide](https://guide.postman.gov.sg/email-api-guide/overview) to find out more.

## What can Postman sms API do?

Head over to our [sms API guide](https://api-docs.postman.gov.sg/) to find out more.

## Is Postman secure?

Emails, SMSes and Telegram messages are not 100% secure. Users should be wary of putting sensitive information directly in your message body. Depending on the level of sensitivity, users can consider using recipient-specific, high-entropy links or requiring further authentication to see sensitive information.

## Can Postman be accessed on the government intranet?

The Postman web app can be accessed on GSIBs that allows Secure Internet Surfing.

## What data can Postman handle?

We use cloud infrastructure so we can handle up to **Confidential (Cloud-Eligible)** data. For more information, you may refer to the section of our guide on [IM8 Policies](https://postman-v1.guides.gov.sg/email-api-guide/overview/im8-policies) (`.gov.sg` login required).

| Normal email/SMS         | Non-sensitive to sensitivity low-normal | <ul><li>Transaction</li><li>Notification</li><li>Information broadcast</li><li>Receipts</li><li>Reminders</li></ul> |
| ------------------------ | --------------------------------------- | ------------------------------------------------------------------------------------------------------------------- |
| Password-protected email | Sensitivity high/restricted             | <ul><li>COVID-19 test result</li><li>Blood test result</li><li>Exam test result</li></ul>                           |

## Difference between the Web App and Programmatic APIs

**Web App:** Users can access Postman by going to <https://postman.gov.sg>. The web app has a user interface that allows users to send templated messages via campaigns.

**Programmatic APIs**: Users who manage their own systems could also call our APIs to send messages programmatically. In order to use this feature, you need to generate an API key from `Settings` in the Postman web app. You can find more by going to our  [sms API guide](https://api-docs.postman.gov.sg/)/[emailAPI guide](https://postman-v1.guides.gov.sg/email-api-guide/overview) here.

| Access Type                                                                    | Channels                     | Type of Use Case             | Prerequisite                                                                                                                                                                                      |
| ------------------------------------------------------------------------------ | ---------------------------- | ---------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| [Web app](https://guide.postman.gov.sg/campaign-guide/quick-start)             | Email, SMS, and Telegram Bot | Manual intervention required | <p><code>@agency.gov.sg</code> email access to log in</p><p><br>You will need to request for a <code>@agency.gov.sg</code> email address from your respective agency if you do not have one. </p> |
| [API](https://github.com/opengovsg/postmangovsg/blob/master/docs/api-usage.md) | Email & SMS                  | System-generated             | Engineering or IT team to send messaging info from the source system to Postman.                                                                                                                  |

## Open-source contribution

Postman is open-sourced. Visit our [GitHub repo](https://github.com/opengovsg/postmangovsg) to start contributing to our code. Contributing guidelines can be found [here](https://github.com/opengovsg/postmangovsg/blob/master/docs/CONTRIBUTING.md).

![](https://4126954886-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MAQH3DF49Lq0AJudrbF%2Fuploads%2Fgit-blob-ea3d372d47c61bfa4492127ddb936c80b53ee8cc%2Fgithub-icon-png-26.jpg?alt=media)


---

# 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://postman-v1.guides.gov.sg/readme.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.