LetterSG

What is LetterSG?

LetterSG is a platform that allows public officers to create, issue and track personalised official e-letters to citizens.

More information about LetterSG can be found here.

Setting up LetterSG connection

1. Click on the ➕ logo in between steps or "Add Step"

2. Select "LetterSG"

3. Under "Choose connection", click the dropdown

4. Click "Add new connection"

5. Under "Label", key in the name you want to associate this connection with

6. Login to LetterSG and follow this guide to obtain the API key. Key it under "API key"

7. Click "Connect"

8. Under "2. Create letter", a green dot will appear as an indication that the LetterSG connection is successful

Create letter

Field	Description	Required?
Template	Sets the template you want for creating a letter	✔️
Export as PDF	Two options to select: Send the letter link directly (recommended): This does not generate a PDF to be sent to the user. Export letter as PDF to send: This generates a PDF which can be used with an "Email by Postman" in the next step.	✔️
Personalised fields	These are variables in your letter template in this format {{field_name}} Click on "+ And" to add all the fields in your template.	✔️

1. Set up your letter by completing the required fields:

   1. Template

   2. Export as PDF

   3. Personalised fields

2. Click on Check step to save and generate a letter for your templated based on the personalised fields you have set up.

Check step

The Check step button saves your set up and tests the Create Letter action by generating a sample letter based on the personalised fields specified. This allows you to verify the letter design before the Pipe is published and the workflow runs automatically.

Common Errors

Personalised field(s) not specified

This happens when you have not selected all the fields required in your template. Check that you have selected those fields that are indicated in the error message before running "Check step" again.

field_name is repeated

This happens when you have selected repeated fields in your setup. Make sure you only include one of each before running "Check step" again.

Field empty

This happens when you have not selected a field in the dropdown. Please make sure you select the required fields for your template.

Value empty

This happens when you have not entered a value for your field. Please make sure you key in the respective value for your template fields.