# Step 4: Configure Your Twilio Account

{% hint style="info" %}
You can only start configuring your Twilio account after you have completed the [setup](/campaign-guide-sms/onboarding-overview/step-3a-receive-your-account-invitation.md).
{% endhint %}

You will first need to configure your Twilio account to ensure that it is functioning and is mapped to your Sender ID. 

Upon configuring your Twilio account, you will be able to obtain the necessary Twilio credentials required for you to input into your Postman campaign. More information can be found in Step 6. Fill in your Twilio credentials in Postman

<figure><img src="/files/7xciMjr7OK9yTKw1CuSU" alt=""><figcaption></figcaption></figure>

### Before you start, note the credentials you'll need to save-keep to input into Postman:

1. [Account SID](https://postman-v1.guides.gov.sg/campaign-guide-sms/onboarding-overview/pages/J89FopQzDZgJb9qSC8yv#id-1.-account-sid)
2. [API Key SID](https://postman-v1.guides.gov.sg/campaign-guide-sms/onboarding-overview/pages/J89FopQzDZgJb9qSC8yv#id-2.-your-api-key-sid)
3. [API Secret (*this is unretrievable once you proceed beyond this step, so make sure you have saved somewhere, or you will need to redo the set-up process to generate new keys*).](https://postman-v1.guides.gov.sg/campaign-guide-sms/onboarding-overview/pages/J89FopQzDZgJb9qSC8yv#id-3.-api-secret)
4. [Messaging Service ID](https://postman-v1.guides.gov.sg/campaign-guide-sms/onboarding-overview/pages/J89FopQzDZgJb9qSC8yv#id-4.-your-messaging-service-sid-without-buying-a-phone-number)

### 1.  Account SID

An account SID is the unique identifier assigned to your agency account, much like an NRIC number. This is immediately available on your dashboard once you log into your account console

<figure><img src="/files/nUwgPoQRwJHiWZl03U2C" alt=""><figcaption><p>Locate your account SID</p></figcaption></figure>

#### 1a. Account SID - Postman v1 campaign settings

Insert your Account SID from your Twilio account console into Postman v1.

<figure><img src="/files/id2cdVmb5qd9vwmW4fBP" alt=""><figcaption></figcaption></figure>

### 2. Your API key SID

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

<figure><img src="/files/zL84tywvSvGXbzk9s3KM" alt=""><figcaption><p>Select "API keys &#x26; tokens"</p></figcaption></figure>

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

<figure><img src="/files/hGwHAUyFOFp5nYLmAuak" alt=""><figcaption><p>Select "Create API key"</p></figcaption></figure>

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.

<figure><img src="/files/KbFJ8e4OqEqhP9L1JSsr" alt=""><figcaption><p>Name your API key, and set key type as "standard"</p></figcaption></figure>

#### 2a. API Key SID - Postman v1 campaign settings

Insert your API Key SID from your Twilio account console into Postman v1.

<figure><img src="/files/yUVF61ywiTNAxnAqGB2M" alt=""><figcaption></figcaption></figure>

### 3. API Secret

When creating your API key, a `secret key` associated with your API key will be shown.

Save your secret key

{% hint style="danger" %}
**Once you lose this secret key or if you do not save it, you will NOT be able to retrieve it again after moving on to the next step**
{% endhint %}

<figure><img src="/files/h9GE68iHwBCLyCdPoyLz" alt=""><figcaption><p>Save the API key SID and Secret Key somewhere safe!</p></figcaption></figure>

Check the box and click `Done`.

{% hint style="danger" %}
Make sure you **copy and save** these details somewhere safe
{% endhint %}

#### 3a. API Secret - Postman v1 campaign settings

Insert your API Secret Key from your Twilio account console into Postman v1.

<figure><img src="/files/7P0QO89MsMsuZ0VJhAvr" alt=""><figcaption></figcaption></figure>

### 4. Your messaging service SID (without buying a phone number)

This is the last detail you need to save before proceeding to Postman.

{% hint style="info" %}
Note: we used to ask users to purchase a US phone number at USD$1.15. This will enable a one-way messaging ability (from you to recipient). With the implementation of the Sender ID regime by IMDA, this is no longer required - *only if you are sending ONLY to Singapore numbers.*
{% endhint %}

**However, if you are sending SMSes to foreign numbers,** you will still need to purchase a phone number. Otherwise, your messages will not be delivered. Find out how to purchase a phone number [here](/campaign-guide-sms/onboarding-overview/step-4-configure-your-twilio-account/what-if-i-need-to-buy-a-phone-number.md), and follow these [steps](/campaign-guide-sms/onboarding-overview/step-4-configure-your-twilio-account/what-if-i-need-to-buy-a-phone-number.md) to set up your messaging service ID. You can ignore the steps below if you are purchasing a phone number.

**If you don't have a need to purchase a phone number, follow these steps to obtain your messaging service SID.**

Go back to your Twilio home page, and select`Set up a Messaging Service`.

<figure><img src="/files/ux7QpOWwm6ZUeFuRCUwt" alt=""><figcaption><p>Click "Set up a Messaging Service"</p></figcaption></figure>

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

<figure><img src="/files/S2Ym2x2dNrWzaJw7PNF2" alt=""><figcaption><p>Create your messaging service</p></figcaption></figure>

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.

<figure><img src="/files/fgYPL2UjwwZVrE5UUdew" alt=""><figcaption><p>Fill in the required details</p></figcaption></figure>

#### Set up your alphanumeric Sender ID

Configure your alphanumeric Sender ID by selecting `Alpha Sender` under `Add Senders > Sender Type.`

<figure><img src="/files/TeYbePQZoKTmNG140mhF" alt=""><figcaption><p>Select "Alpha Sender"</p></figcaption></figure>

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

<mark style="color:red;">**Specify the Alphanumeric Sender ID you want to use in the text box. It is best to align this with the Sender ID that you registered with SGNIC.**</mark>

<figure><img src="/files/yJ9cxKYdF8s4oE1Wp9kV" alt=""><figcaption><p>Add in your Sender ID</p></figcaption></figure>

**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.

<figure><img src="/files/LoY4sgXt5L3u5WiJ3KvM" alt=""><figcaption><p>Complete the set up</p></figcaption></figure>

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

<figure><img src="/files/piSZsuNpBTvG28GU2sHI" alt=""><figcaption><p>This is your messaging service SID</p></figcaption></figure>

#### 4a. Message Service ID - Postman v1 campaign settings

Insert your Messaging Service SID into Postman v1.

&#x20;

<figure><img src="/files/uEJu2QYCyf0FXvoJixhO" alt=""><figcaption></figcaption></figure>

#### Or, watch this video for a visual learning experience!

{% embed url="<https://youtu.be/Ez5pfGgmFEA>" %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://postman-v1.guides.gov.sg/campaign-guide-sms/onboarding-overview/step-4-configure-your-twilio-account.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.