Postman Guide
Go to Postman v1
  • 🥳About Postman v1 (Postman Legacy)
  • Campaign Guide - General
    • 🚀How to send a campaign?
      • ☝️Before You Start
        • Demo Mode
  • Campaign Guide - Email
    • 📧Email Campaigns - Basics
      • How do I send an email campaign?
      • Scheduled Sending
      • Bounced Emails and Halted Campaigns
      • Email Statistics
      • Formatting your Message Template
      • Variable Fields
      • Unique URL Link per Recipient
      • Pasting Content from Microsoft Word
      • Manage your Unsubscriptions
      • Understanding Unsubscriptions
    • 🔐Sending Password-Protected Emails
      • Tutorial
      • Template Editor
  • Campaign Guide - SMS
    • 📲SMS Campaigns - Basics
      • Before Starting Out
      • Summary of Costs
    • 🪜SMS Onboarding Overview
      • Step 1: Sender ID Registration
      • Step 2: Sign up for a Twilio account
      • Step 3: Set up your Twilio account
      • Step 4: Configure Your Twilio Account
        • What if I need to buy a phone number?
      • Step 5: Send a Test Message on Twilio
      • Step 6: Fill in your Twilio credentials in Postman!
        • How do I send a campaign with my saved SMS credentials?
    • 🤔What else do I need to know about sending SMSes?
      • More about Sender ID registration
      • Can I see the send status of my campaign?
      • How can I configure my SMS send rate?
      • Sending an SMS to a Foreign Number
      • SMS Best Practices
      • Useful Twilio Links
  • Campaign Guide - Telegram
    • 🤖Telegram Campaigns - Basics
      • How do I set up Telegram to send my campaigns?
      • Add Telegram Bot Token in Postman
      • Instructions for Recipient Onboarding
      • Use the Bot in the Campaign
      • Telegram Formatting
      • Telegram Bot Statistics
  • Email API Guide
    • 📖Overview
      • IM8 Policies
      • Connecting your Intranet Application
      • API Response Formats
    • 🗝️Email API Key Management
      • Bearer Authentication
      • Generate your email API Key
      • Rotate your email API Key
    • 📨Programmatic Email API
      • Getting Started
      • Comparison with AMR
      • SG-Mail Whitelisting
      • Custom From Address
      • Tracking Email Status
      • Send Email API
        • From Name and From Address
        • CC and BCC
        • Recipient Blacklist
        • Email Tagging and Classification
        • Email Body
          • Embedding Images
            • Linked Images
            • Content-ID Images
        • Attachments
        • Rate Limit
      • Get Email by ID API
      • List Emails API
    • 📨Programmatic GovSG WhatsApp API
      • Getting Started
      • Tracking Message Status
      • Get Available Templates API
      • Send Message API
      • Get Message by ID API
      • List Messages API
    • 🎓Frequently Asked Questions
  • FAQ
    • 📶Service Status
    • For Recipients
      • Check Email Authenticity
    • For Senders
      • Messaging Channel Comparison
      • Cost Breakdown
  • Legal
    • Terms & Conditions
    • Privacy Policy
  • Contact Us
  • GitHub
Powered by GitBook
On this page
  • Why custom from address?
  • How to set up custom from address?
  • Step 1 - Contact the Postman team
  • Step 2 - Postman will generate and send agency DKIM records
  • Step 3 - Agency to add DKIM records to their DNS
  • Step 4 - Postman to add the specified from address into our database
  • Step 5 - Agency to verify if configuration is successful
  • Sending to Intranet .gov.sg recipients?

Was this helpful?

  1. Email API Guide
  2. Programmatic Email API

Custom From Address

Send emails from your agency's own email address

PreviousSG-Mail WhitelistingNextTracking Email Status

Last updated 9 months ago

Was this helpful?

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

Updated 2 September 2024: Postman's default sender email address has been changed from donotreply@mail.postman.gov.sg to info@mail.postman.gov.sg

By default, all emails will be sent from Postman's email address info@mail.postman.gov.sg

Why custom from address?

There are two main reasons why you might want to set up a custom from address:

First, you wish to send emails using your agency's own email address. We understand that agencies wish to retain their own branding and enhance the perceived legitimacy of their emails by sending emails from their own domains. To achieve this, setting up a custom from address is necessary.

We wish to note that the from name can be changed without changing the from address. The example below highlights the difference between from name and from address:

In the example below, the from name is New Product, whereas the from address is <test-admin@postman.gov.sg>.

As such, for agencies that do not wish to go through the hassle of setting up custom from addresses, an intermediate solution might be to change the from name.

How to set up custom from address?

The following steps outline the process of setting up custom from address on Postman.

Create an account on Postman using the email address that you want to send your email from.

For example, if you want your email to be sent from no-reply@agency.gov.sg, you should log into Postman using this email address and generate your API keys on the dashboard.

Do buffer in some time before you embark on this or let us know ahead of time if your request is urgent.

  • Your use case (if you have not shared with Postman team previously)

  • The sender email address that you intend to send your email out from (e.g. <no-reply@agency.gov.sg>).

  • Please also inform us of any deadlines so that we can prioritise your request accordingly

Step 2 - Postman will generate and send agency DKIM records

As the DKIM records is manually generated by the Postman team, this may take a few days to a week depending on our availability and the urgency of your request.

Postman team will send you the DKIM records in the form of a .csv file. There are up to 9 records in the file.

Step 3 - Agency to add DKIM records to their DNS

We recommend that you add your records within 3 days of receiving the .csv file to avoid delays.

  • Create CNAME records in DNS (ITSM/DNS Provider) and make sure that you add all records into your DNS. Failure to do so might result in some of your email being dropped.

  • If you have both internet and intranet zones of the same domain, make sure you add it to both zones.

  • If you do not have access to your DNS records, you should speak to your ITD who has access to your agency domain (this is the domain that you want to send the email from, e.g agency.gov.sg) on ITSM.

Step 4 - Postman to add the specified from address into our database

This step establishes a link between our infrastructure and our application code.

Step 5 - Agency to verify if configuration is successful

Postman uses Amazon SES, which may take up to 72 hours to complete the verification process.

Sending to Intranet .gov.sg recipients?

For more information, .

Second, you wish to send emails with attachments. Currently, we only allow sending of attachments using custom sender email. For more information, .

Step 1 -

Fill in this . Please include the following information in your request:

To check if the configuration is successful, you can either try sending an email using API or log into portal and see if you are able to select your custom domain e.g no-reply@agency.gov.sg to send your campaign.

Most agency domains would have been whitelisted on Postman but if your domain is recently created and you are not sure if it has been whitelisted, you can to us.

Read for more information.

📨
see here
see here
Contact the Postman team
form
Postman
reach out
this
(1) From Name and (2) From Address