Sending SMSes using NRIC
The Postman team will release the API specs and test environment for this feature after April 20, 2025.
This feature is only available to selected users who were previously using Notify.
If you did not receive an invitation by the Postman team to use this endpoint, you will not be able to use this feature.
What is this feature about?
This feature enables agencies to send messages to recipients using their NRIC instead of phone numbers, supporting the transition from Notify to Postman. Previously, some agencies relied on Notify for message delivery when they only had access to recipients' NRICs.
Authorised users can make API calls to Postman by providing the recipient's NRIC. The system will retrieve the associated phone number and deliver the message to the recipient. Users can expect the same experience they had with Notify.
This feature is exclusively available for authorised users, only through the Postman API.
Does this guarantee my messages will be sent to the recipient, as long as I have their NRIC?
No.
If the recipient does not have a phone number mapped to his/her NRIC in Singpass, no messages will be sent to the recipient even if you have their NRIC.
Release Schedule
Test Environment
The API specifications and feature will be available in Postman's test environment after April 20, 2025.
Production Environment
The target release date is June 2025, subject to potential delays.
Is there anything I will need to do before the release of this feature
Existing Notify users should have already received an email containing specific instructions and a form. You must complete this form before accessing the new feature in Postman's test environment.
What this does?
In Postman's test database, we will create a simulated database mapping unique identifiers to mobile numbers. These unique identifiers are designed to simulate NRIC-to-mobile number mapping, but they are not actual NRIC numbers.
When a form is submitted, Postman will assign a unique identifier to each submitted phone number in our test environment. Once this process is complete, we will inform agencies of the mapping.
When you make an API request using one of these unique identifiers, we will send a message to the corresponding phone number.
However, when calling our endpoints with a real NRIC, no message will be sent, as the test environment does not have real NRIC data; users should only call the unique identifier provided to them.
Attributes (sending SMSes using NRIC)
recipient (send smses using nric, mandatory)
To trigger a message to be sent to a mobile number when the recipient’s NRIC is provided, you will need to make some changes to the recipient attribute
value
SXXXXXXXA
The recipient’s NRIC number, case sensitive
type
nric
Explanation of the value
Endpoints (sending SMSes using NRIC)
Test environment:
The value should be the unique identifier assigned to the phone number you have previously submitted.
If the value used in our test environment is a real NRIC, no message will be sent out and a HTTP 400 error will be returned instead.
The following diagram illustrates how the message is created on Postman and sent to recipients.
Last updated
