# Programmatic Email API

{% hint style="warning" %}
**Updated 26 September 2023:** Postman will no longer be onboarding any new programmatic API users nor create new custom from addresses till further notice.
{% endhint %}

We provide a **modern, cost-effective, and compliant PaaS** for to send programmatic emails.

## What are programmatic emails?

These are emails that are triggered by a computer system, typically as part of a larger workflow.

For example, consider an agency that receives grant applications from members of the public. When an applicant submits a grant on your website, upon receiving the submission, your system could call our API to send out an acknowledgement email. The same could be done for sending one-time-passwords (OTPs), appointment booking confirmations, status updates emails, and so on.

Our existing users include both external agencies, such as ICA, CPF, and MOM, as well as OGP products, such as [Health Appointment System](https://book.health.gov.sg/), [Isomer](https://www.isomer.gov.sg/), [CheckWho](https://checkwho.gov.sg/login), and [Care360](https://care360.health.gov.sg/login).

## Value proposition

Our product is built on top of the commercial cloud and thus is aligned with the Government's "Commercial Cloud First Policy" to unlock the benefits of the cloud, such as improved reliability, auto-scaling, and lower costs.

For Intranet users, our API is most similar to App Mail Relay (AMR). For more details:

* [IM8 Policies](https://postman-v1.guides.gov.sg/email-api-guide/overview/im8-policies)
* [Comparison with AMR](https://postman-v1.guides.gov.sg/email-api-guide/programmatic-email-api/comparison-with-amr)

For Internet users:

* By using our PaaS service allows you to abstract away the undifferentiated heavy lifting of setting up and maintaining your own email sending system, allowing you to focus on your core business logic.
* Compared to commercial PaaS, our product is free for government agencies to use and is set up to ensure deliverability to SG-Mail recipients.

## Feature list

* Modern, cloud-native, self-serve
* Free. No GeBiz purchase order to submit, no billing or invoices to deal with.
* [IM8-compliant](https://postman-v1.guides.gov.sg/email-api-guide/overview/im8-policies)
  * As a product of [Open Government Products](https://www.open.gov.sg/), we are exempt from IM8 policies.
  * Nonetheless, we strive to build our policies in a manner that is consistent with SNDGO's Cloud Security Policy.
* [Attachments](https://postman-v1.guides.gov.sg/email-api-guide/programmatic-email-api/send-email-api/attachments)
* [Custom domain](https://postman-v1.guides.gov.sg/email-api-guide/programmatic-email-api/custom-from-address)
* [Email tagging and classification](https://postman-v1.guides.gov.sg/email-api-guide/programmatic-email-api/send-email-api/email-tagging-and-classification)
* [Tracking email status](https://postman-v1.guides.gov.sg/email-api-guide/programmatic-email-api/tracking-email-status)
* Endpoints for [querying email](https://postman-v1.guides.gov.sg/email-api-guide/programmatic-email-api/get-email-by-id-api) and [listing emails](https://postman-v1.guides.gov.sg/email-api-guide/programmatic-email-api/list-emails-api)
* [SG-Mail whitelisting](https://postman-v1.guides.gov.sg/email-api-guide/programmatic-email-api/sg-mail-whitelisting) to ensure delivery to Intranet recipients
* [Multiple API keys for regular key rotation](https://postman-v1.guides.gov.sg/email-api-guide/api-key-management)
* Rolling deployment with zero downtime

## Express interest and FAQs

{% hint style="warning" %}
**Updated 26 September 2023:** Postman will no longer be onboarding any new programmatic email API user till further notice.
{% endhint %}

If you have any queries, you can check out this [API FAQ page](https://postman-v1.guides.gov.sg/email-api-guide/frequently-asked-questions).


---

# 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/email-api-guide/programmatic-email-api.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.