# Email by Postman

## What is Postman?

Postman is a mass messaging tool for the Singapore Government. To date, Postman has sent out more than 100 million messages from over 90 agencies. These include quarantine orders, COVID-19 test results, and employer notices.

More information about Postman can be found [here](https://guide.postman.gov.sg/)

## Send email

<table><thead><tr><th width="204.05859375">Field</th><th width="410.37109375">Description</th><th>Required?</th></tr></thead><tbody><tr><td>Email subject</td><td>Sets the subject line that recipients will see in their inbox.</td><td><span data-gb-custom-inline data-tag="emoji" data-code="2714">✔️</span></td></tr><tr><td>Body</td><td><p>Sets the main content of the email, which the recipient will see in the message area.</p><p></p><p>You can enter plain text, use variables from previous steps to personalise the message, or format it with the editor to add tables, images, and links.</p></td><td><span data-gb-custom-inline data-tag="emoji" data-code="2714">✔️</span></td></tr><tr><td>Recipient email(s)</td><td><p>Sets the email address(es) of the recipient(s).</p><p><br>Note: each recipient will receive an individual email.</p></td><td><span data-gb-custom-inline data-tag="emoji" data-code="2714">✔️</span></td></tr><tr><td>CC recipient email(s)</td><td><p>Sets the recipients to be CC’d on every email.</p><p><br>Note: CC recipients will receive a separate copy of the email for each main recipient. For example, if there are 5 main recipients, each CC recipient will receive 5 emails.</p></td><td></td></tr><tr><td>Sender name</td><td><p>Sets the from name for the email.</p><p></p><p>For example, setting "Your custom name", this name will appear in the from field of the email sent to recipients.<br><img src="/files/HwM4bXbTO2FCToXHBgQJ" alt=""></p></td><td><span data-gb-custom-inline data-tag="emoji" data-code="2714">✔️</span></td></tr><tr><td>Reply-To email</td><td><p>Sets the Reply-To address for the email.</p><p></p><p>When recipients click Reply, their response will be directed to this address instead of the From address.<br>For example, setting "support@plumber.gov.sg" means replies will be sent to that address.<br><img src="/files/UKnbzJBegQkJJTZiXktK" alt=""></p></td><td>If left blank, it defaults to your email address.</td></tr><tr><td>Attachments</td><td>Add attachments to your emails from multiple sources, including FormSG, LetterSG, and manual uploads. For a list of supported file types, refer to the Postman documentation <a href="https://guide.postman.gov.sg/email-api-guide/programmatic-email-api/send-email-api/attachments#list-of-supported-attachment-file-types">here</a>.<br><br>To upload your own files:<br>1. Click on the <strong>Uploaded attachments</strong> tab<br>2. Upload your own files<br>3. Select them from the list</td><td></td></tr></tbody></table>

1. Set up your email by completing the required fields:
   1. **Email subject**
   2. **Body**
   3. **Recipient email(s)**
   4. **Sender name**
2. Set up the optional fields, if required.
3. Click on **Check step** to save and send an email to the address(es) specified in **Recipient email(s)**

## Check step

The **Check step** button saves your set up and tests the Email by Postman action by sending a **real** email to the address(es) specified in the **Recipient email(s)** field. This allows you to verify the email output before the Pipe is published and the workflow runs automatically.

## Common errors

<details>

<summary>Blacklisted recipient</summary>

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

This happens when email addresses are added to the Postman blacklist after a delivery attempt results in a hard bounce (e.g., the email address does not exist).&#x20;

Click the link to submit a request to remove the email from the blacklist. Once you receive a notification from Plumber confirming the removal, try sending the email to the recipient again.

</details>

<details>

<summary>Total attachment size exceeded</summary>

This happens when the cumulative size of all attachments exceed the limit imposed by Postman.

You should check that the attachments do not exceed 10 MB in total.

</details>

<details>

<summary>Invalid attachment</summary>

This happens when password-protected attachments are sent in your email.

You should remove the password-protected attachment.

</details>

<details>

<summary>Invalid recipient emails</summary>

There is an invalid email in the field (e.g., invalid-email.com).

</details>

<details>

<summary>CC recipient did not receive email</summary>

The email status of CC recipients is not tracked by Postman, which means no blacklist notification will be sent.

In such cases, you will need to manually resend the email to the blacklisted CC recipient.

More details can be found [here](https://postman-v1.guides.gov.sg/email-api-guide/programmatic-email-api/send-email-api/cc-and-bcc).

</details>


---

# 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/user-guides/actions/email-by-postman.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.
