Postman v2 Guide
Go to Postman v2
  • Postman v2 API Docs
    • πŸ€–About Postman v2
      • Postman v2 SLOs
    • Postman v2 SMS API user documentation
    • πŸ“ΆService Status
    • ⏰Postman Guide latest updates
    • πŸ‹οΈImportant dates
    • πŸ›’Useful Links
  • Postman v2 general user guide (MoP)
    • πŸ”Logging into Postman v2
    • πŸ“’Create Campaign
      • Message Preview
      • Language tab
      • Message content
      • Character count
    • πŸͺ΅Message Logs
    • Deleting campaigns
  • Postman v2 Admin Portal, for UI Users (MOP)
    • πŸ“€Sending messages via the Admin Portal
  • Postman v2 Admin Portal for API users (MOP)
    • βš™οΈCampaign Settings
    • πŸ–₯️Sending Messages via Postman API
  • πŸͺͺSending SMSes using NRIC
  • Postman v2 admin portal, for UI users (Internal)
    • Internal SMS
    • Information for new Twilio users
    • Summary of Costs
    • How do I onboard Postman v2 Internal SMS
      • 1. Sender ID Registration
      • 2. Sign up for a Twilio account
      • 3. Set up your Twilio account
      • 4. Fill your Twilio credentials on Postman
        • What if I need to buy a phone number?
      • 5. Send a Test Message
  • General notes for API users
    • πŸ—’οΈOverview
    • Authentication
    • API Errors
    • Message Delivery Errors
    • Pagination
    • Rate Limits
  • Endpoints for API users
    • πŸ“žEndpoints for API users
    • The message object
    • Single Send
    • Single Send - Retry
    • Retrieve Message
    • Batch Send
    • Batch Send - Retry
    • Retrieve Batch
    • Retrieve Campaign Message
  • SFTP
    • πŸ“‚SFTP Integration
    • πŸ—οΈGenerating SSH Keys
    • Connecting to the SFTP server
    • Sending messages via SFTP
    • Checking whether sending via SFTP is successful
  • Load Test
    • Load Test Booking Requirement
  • FAQ
    • ❓Postman v2 FAQ
      • General Q&A
      • Sending emails to users (Legacy Postman)
      • Access related inquiries
      • Platform access related inquiries
      • User Access
      • API keys generation and IP Address whitelisting
      • Delivery Report
      • Messaging
      • Message Statuses
      • Integration and configuration related inquiries
      • Delivery rate
      • File types
      • SFTP and other integration methods
    • πŸ’»Postman v2 API FAQ
      • API keys generation
      • Campaign related inquiries
      • API related inquiries
      • IP Address related inquiries
    • πŸ—ƒοΈSFTP and Other integration methods
  • Legal
    • Terms & Condition
    • Privacy Policy
  • Call App
    • Terms & Condition
    • Privacy Policy
Powered by GitBook
On this page
  • Message content
  • Message parameters (variables)
  • Additional notes to message content
  • Possible replacements to unsupported characters
Export as PDF
  1. Postman v2 general user guide (MoP)
  2. Create Campaign

Message content

PreviousLanguage tabNextCharacter count

Last updated 10 days ago

Message content

This flow allows you to create your own message in Postman using an editor and can be used by both admin portal and API users.

For API users who do not want to manage your message templates within Postman, click for more information.

Message parameters (variables)

You can create multiple {{variables}} when typing out your message content. You can then input the values of each {{variable}}when you send the message from the admin portal or via API.

Variables have to fulfil the following in order to be successfully created

  • Can only contain lowercase letters, numbers and _

  • Must start with a lowercase letter

  • If multiple languages are selected, the same variables must be present in all language tabs.

  • Characters are within the GSM-7 character set. See section below on unsupported characters for more info.

Additional notes to message content

Unsupported characters

It is recommended to NOT paste message content into Postman from another editor/MS word/Outlook etc., as this may convert characters into unsupported (non-GSM-7) characters. Please type the message content directly into Postman.

Postman message segment calculator

  • identify unsupported characters within your message content

  • identify non GSM characters within your message content

  • check the number of message segments

This is what happens if you include unsupported characters in your messages:

  1. unsupported characters changes the message encoding and therefore, significantly increases the number of message segments per SMS.

  2. besides cost, long messages with multiple segments will jam the send queue, affecting even the campaigns of other agencies besides your own.

  3. Reliability of sending messages cannot be guaranteed beyond 7 message segments per SMS, a limitation imposed by telcos. Hence, we advise you to keep your messages below 7 segments.

Blocking unsupported characters at the UI and API layers [English language only]

Message content containing unsupported characters will be blocked from sending.

  1. On the UI:

Campaign templates that contain unsupported characters cannot be created on the UI/Postman admin portal. This blocking has been implemented since June 2024.

  1. On the API:

If your message content is created only at the API layer, we will implement blocking on the Postman production environment from 5 May 2025. This blocking will be available on the Postman test environment from 17 February 2025.

Error message if your message contains unsupported characters at the API layer:

{
	"error": {
		"code": "parameter_invalid",
		"message": "Parameter values cannot contain avoidable expensive characters. Please refer to the guide (https://postman-v2.guides.gov.sg) to learn more.",
		"type": "domain_error",
		"id": "8758298681140894082"
	}
}

Trailing white spaces in variables

Note that the content within your variables should not start nor end with a space, as this will trigger an error where your message will not be created (400 Bad Request).

eg. "Please report to Clinic A ."

In this example, contents in the variable are coloured, and the trailing spaces at the start/end of the variable content are highlighted in blue. The additional spaces will trigger an error where your message will not be created in Postman.

Possible replacements to unsupported characters

Excluded/unsupported Characters
Description
Possible Replacements that Postman supports

|

vertical line and variants

I (uppercase i)

€

euro

EUR

{

left curly bracket and variants

(

}

right curly bracket and variants

)

[

left square bracket

(

]

right square bracket

)

~

tilde and variants

-

\

backslash and variants

'

`

backtick (note that this is not an apostrophe ' . You can find it to the left of the "1" on your keyboard) and variants

"

β€˜

acute accent and variants

'

β€œ

double prime quotation mark and variants

"

”

reversed double prime quotation mark and variants

"

Β¬

logical negation

-

Β«

left-pointing double angle quotation mark

"

Β»

right-pointing double angle quotation mark

"

❝ or ❛

heavy double/single turned comma quotation mark ornament

"

❞ or ❜

heavy double/single comma quotation mark ornament

"

Γ·

division sign

/

ΒΌ, Β½

vulgar fractions and variants

1/4, 1/2 etc.

β€’

bullet point

-

βŠ›, ✒, ✣, ✀, βœ₯, ✺, ❃, ⧆ etc

asterisk and variants

*

You may make use of to

Messages containing avoidable unsupported characters will be blocked from sending. Please use the to check your message before sending.

Details have been sent to you via email on 7 February 2025, and also available on the policy guide .

Note that this unsupported character list below is not exhaustive. Please use the to check your message for unsupported characters.

πŸ“’
Postman's message segment calculator
message segment calculator
here
message segment calculator
here