Configure your Twilio Account

Information you will need to keep at the end of the set-up, to key into your Postman dashboard:

• account SID

• API key SID

• secret key

• messaging service ID

Your account SID is on the dashboard when you log in to your agency's account console. This is the unique identifier assigned to your agency account, much like an NRIC number.

Step 1: Set up technical details

a) Set up a Standard API Key

To set up your API key for Postman, select API keys & tokens on the side dashboard under Accounts.

Then, create a new standard API key by selecting Create API key.

Create a friendly name for your API key so you can easily identify it in the future, and select Standard as the API key type.

We need your Account SID and secret key for Postman. Please keep these safe.

Remember to save the secret key somewhere, as you will not be able to retrieve it again after moving on to the next step.

Once you have it stored somewhere safe, check the box and click “Done”.

b) Buy a phone number

A Singapore phone number is USD$80 per month. We recommend that you buy a US phone number which is USD$1.15 per month. Aside from cost savings, the US phone number is sufficient for Postman's current capabilities in sending 1-way messages (from you to recipient).

If you have use cases for 2-way SMS (in which case a Singapore number will be necessary), please reach out to us here.

How to buy a phone number?

On the left console, select Develop > Phone Numbers > Manage > Buy a number.

Then select the phone number that you prefer.

c) Set up your messaging service on Twilio

You need to create a messaging service and tie the phone number that you bought to this messaging service before you can send SMSes.

Create a new messaging service

Go back to your Twilio home page, and selectSet up a Messaging Service.

On the side bar, click Develop > Messaging > Services > Create Messaging Service.

Name your messaging service and indicate the purpose. This will help you better identify your use cases if you have multiple, and will also help Twilio detect your specific use case quicker should you need their help for troubleshooting.

Add Sender Pool

Sender Pool is where you configure the sender details such as the phone number you bought, and input your alphanumeric SenderID.

Click Add Senders

Add the phone number you purchased to this service.

Select the number you want to associate with this messaging service (if you have more than one).

d) Configure Alphanumeric SenderID on Twilio

The steps below are in addition to registering your SenderID with SGNIC. Both steps are necessary to complete the set up process.

On your Twilio console

Click on Add Senders and select Alpha Sender. This must be done after you configure the phone number setup in Step 4.

Click Continue. You may ignore the notification indicating that Alphanumeric Sender is not enabled for this account.

Specify the Alphanumeric Sender ID you want to use in the text box. It is best to align this with the SenderID that you registered with SGNIC.

If the Alphanumeric Sender ID you chose is protected, you will notice either of the two things below.

• You encounter an error when setting it up on the Sender Pool page

• You may not receive any message when you send a test SMS

This also means that this Sender ID has been registered by another entity and you will not be able to use it.

Once you have completed the step above, you may Click the Skip Setup Button below.

Step 2: Get your Messaging Service ID

After clicking "Skip setup" in the step above, you should be brought to the Properties page of this Messaging Service.

Copy Messaging Service ID

On this page, you should be able to find the Messaging Service ID that we require you to key into Postman.

Step 3: Name your account

This step helps us and Twilio better identify your account should you need help, without having to go into your account itself, which we prefer in order to respect the privacy and security of your account.

Go to Account > General settings > Account details > Account name

And rename your account with the format Agency-Department name-Use case

Step 11: Send a test message to yourself

Navigate back to the console and under Try it out, select Send an SMS. Insert your own phone number and select the messaging service that you've just setup earlier in Step 4.

Type your message and click send to check if you receive the SMS and if the SenderID is accurate.

If you don't receive your test SMS, it is likely that this SenderID has been taken by another agency. You should use another Alphanumeric Sender ID. Otherwise, you may reach out to Twilio's support team for help.

Once you've setup your Twilio Account, you should insert the required fields into Postman and you can start sending out SMS through Postman using this Twilio credential.

You should not need to configure your Twilio account in the future.