# Sending Out Letters

## How do I send out generated letters to recipients via SMS?

{% hint style="info" %}
**Note:** LetterSG has switched to the gov.sg SMS sender ID. <br>

If you are eligible to use gov.sg, no action is required on your part—everything is automatically set up for you.<br>

If you are a LetterSG user and you want your LetterSG SMS to show your agency’s name in the message header, please approach your agency’s nominated person-in-charge (PIC) to integrate LetterSG with a Postman campaign.
{% endhint %}

1. **Select "SMS" for the options under how you would like to send out your generated letters. You will see preview of the message that will be sent out to your recipient under the LetterSG Sender ID on the right.**

   <figure><img src="/files/3io9w8QpyIHbiE0xZdrb" alt=""><figcaption></figcaption></figure>

   If you would like to preview how the message will look like for your recipients, you can also do so by sending a test letter to yourself.
2. **If it is your first time generating letters with this template, click on "Download Sample" to download a sample CSV file to fill up.**&#x20;

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

3. **Fill up your CSV file with the information you wish to be personalised in each letter as well as your recipients' phone numbers like in the example below.**

{% hint style="warning" %}
Note: Ensure to format your CSV file properly to avoid errors in the upload process, eg. omitting empty rows/cells.
{% endhint %}

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

* LetterSG will add the +65 for you automatically when you enter the eight-digit phone number for a Singapore phone number.
* We currently **do not** support sending of LetterSG links to foreign numbers. If you require such a feature, please let us know through this form: <https://go.gov.sg/lettersg-feature-request>

4. **Drag and drop the file into the upload area. If your CSV file is formatted properly, a success screen like this should show up.**&#x20;

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

5. **Once you have verified that the SMS looks good, you can click the button to "Next: Review and send". A final confirmation popup will appear, and you can click on the button to confirm sending out the letters.**

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

7. **You will be redirected to the dashboard where you can view all the information regarding the letters that you sent out.**

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

### What will citizens see when they receive the SMS and click on the link?

* When citizens receive the SMS, it should look something like this:

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

* When citizens click on the link, it should look something like this:

<figure><img src="/files/mlS5V1NrHeZ7c5f0g9lK" alt="" width="375"><figcaption></figcaption></figure>

### How do I send SMSes to foreign numbers?

We currently do not support sending of letters to foreign numbers.

## How do I send out generated letters to recipients via email?

1. **Select "Via email" for the options under how you would like to send out your generated letters. You will see preview of the email that will be sent out to your recipient on the right.**

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

Agency users will see the name and logo of their own agency as the issuer, instead of "Open Government Products".

If you would like to preview how the email will look like for your recipients, you can also do so by sending a test letter to yourself.

2. **If it is your first time generating letters with this template, click on "Download CSV template here" to download a sample CSV file to fill up.**&#x20;

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

3. **Fill up your CSV file with the information you wish to be personalised in each letter as well as your recipients' email addresses like in the example below.**

{% hint style="warning" %}
Note: Ensure to format your CSV file properly to avoid errors in the upload process, eg. omitting empty rows/cells.
{% endhint %}

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

For email sending, you can specify up to 2 recipients per letter. To do so, simply separate the email addresses with a semicolon (;) in the Email(s) column.

4. **Drag and drop the file into the upload area. If your CSV file is formatted properly, a success screen like this should show up.**

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

4. **Once you have verified that the email looks good, you can click the button to "Next: Review and send". A final confirmation popup will appear, and you can click on the button to confirm sending out the letters.**

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

7. **You will be redirected to the dashboard where you can view all the information regarding the letters that you sent out.**

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

## What will citizens see when they receive the email and click on the link?

* When citizens receive the email, it should look something like this. The agency name and logo will be replaced with the agency name and logo.

  <figure><img src="/files/bdaPzb95Xp71aEtwgvLs" alt=""><figcaption></figcaption></figure>
* When citizens click on the link it should look something like this:

<figure><img src="/files/tTwNcvALZeTbrp7yXD7A" alt="" width="375"><figcaption></figcaption></figure>

## How do I send out generated letters to recipients via other services?

1. **If it is your first time generating letters with this template, click on "Download CSV template here" to download a sample CSV file to fill up.**&#x20;

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

2. **Fill up your CSV file with the information you wish to be personalised in each letter like in the example below.**

{% hint style="danger" %}
Note: Ensure to format your CSV file properly to avoid errors in the upload process, eg. omitting empty rows/cells.
{% endhint %}

<figure><img src="/files/1m6bRawG4jpEHSjeTBbs" alt=""><figcaption></figcaption></figure>

3. **Drag and drop the file into the upload area. If your CSV file is formatted properly, a success screen like this should show up.**

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

4. **Once you click on "Next: Create letter links", you will see a confirmation screen like this.**

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

* **Upon clicking on "Download letter links", you will get a CSV that looks like the screenshot below, with 2 new columns on the right ("date\_of\_issue" and "letter\_link").**

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

5. **By adding a separate column named "recipient" and adding the email address you wish to send the letters to, you will be able to use this file to upload onto** [**Postman**](https://postman.gov.sg/) **to send out to your intended recipients!**&#x20;

* For more information on this, please refer to Postman's guide here: <https://postman-v1.guides.gov.sg/campaign-guide-email/email>

<figure><img src="/files/6mBXigtHjHKjaabY0Qdh" alt=""><figcaption></figcaption></figure>


---

# 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://guide.letters.gov.sg/for-agency-users/sending-out-letters.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.
