Getting Started

This page gives you an overview of what to expect when onboarding to Postman Programmatic Email API. Onboarding is mostly self-service, with one exception listed below.

If you’re unsure if Postman Programmatic Email API is a good fit, get started by reading the following pages:

• If you're an existing AMR user, you can check out this comparison with AMR

• Learn more about the relevant IM8 Policies

• Find out how to connect your Intranet application to our API

Ready to onboard?

Updated 26 September 2023: Postman will no longer be onboarding any new programmatic API users nor create new custom from addresses till further notice.

Here are the following steps to take note to help you onboard more smoothly.

Step 1: Decide on a sender name and from address

You can configure your from address to be either:

• The default from address: [e-mail]

• A custom from address (e.g. [e-mail])

This decision will determine if you require our team's support to configure a custom from address. More info on this can be found here.

Step 2: Understand what content you will be sending

To ensure that your content can be sent successfully, you should read these pages ahead of time.

• Are you sending any attachments?

• Are you sending images?

• Is the default send rate of 10 message/s sufficient for your use case?

Step 3: If you want to send the emails from your own custom sender email, contact Postman team here

This step is optional, and only needed if you wish to set up a custom from address in step 1.

Setting up custom sender email typically takes agencies up to 2 weeks to complete so make sure you add buffer time for this step. You may refer to this page for more details.

Step 4: Generate API Key on Postman.gov.sg

Log in to Postman.gov.sg using the sender email address identified in Step 1 and generate the API Key. This API key will be used to authenticate your requests. You may follow the steps outlined here.

If you wish to use a custom from address, please note that the email address with which you use to log into Postman must be the same as the address from which you wish to send emails.

Step 5: Start sending your test emails

Refer to the steps here on how you can start sending your first email. Note the specific instructions on the email body, attachments and email tagging and classification.

As you integrate with the API:

• Find out more about the status codes and responses you may encounter
• Understand the various email statuses and error codes you may encounter

Step 6: Communicate go-live date to Postman Team

If you need additional support, let us know your expected go-live date. If you have reached this step independently, do give us a heads up through this form before you go live.

Step 7: Tell us about your experience

We always strive to improve your user experience and it would mean a lot to us if you could take a few minutes to let us know how your experience was by filling in this form.