GatherSG

GatherSG is a lightweight customer relationship management (CRM) tool designed for seamless collaboration and productivity. It helps you digitalise your operations with minimal development effort.

More information about GatherSG can be found here.

When creating your API key on GatherSG to use with Plumber, ensure that you have granted the Admin role.

How to create an API key on GatherSG?

1. Go to Settings

2. Navigate to API Keys

3. Create a new API Key, and name it accordingly.

4. Choose the appropriate permissions.

5. Save your API key safely.

Adding a new GatherSG connection

Field	Description	Required?
Label	Enter the desired name for your connection.	✔️
API key	Enter the API key that you created on GatherSG.	✔️

Update case

Use this action to update an existing case in GatherSG. For example, you can update a case status (e.g. from Pending to Approved) or modify existing field values.

This is useful when automating case progression or syncing status updates.

Field	Description	Required?
Case UUID	Select the Case UUID for the case you want to update.	✔️
Case status	Select the status to update the case to.
Case fields	Select the fields and enter the values you want to update.

Tag/untag case

Use this action to add or remove tags from an existing case in GatherSG. Tags help you group and filter cases easily on GatherSG, for example by marking certain cases as High Priority or Follow-up Required.

Field	Description	Required?
Case UUID	Select the Case UUID of the case you want to tag or untag.	✔️
Tag or untag	Select whether you want to add or remove a tag from the case.	✔️
Tag value	Enter the tag value.	✔️

Create case

Use this action to create a new case in GatherSG. You can select the case type, specify its initial status, and fill in the necessary fields that define the case.

This action is typically used when you want to automatically create new case entries in response to a new form submission or other trigger.

Field	Description	Required?
Case type	Select the type of case you want to create.	✔️
Case status	Select the status to assign to the new case.
Case fields	Select the fields and enter the values to include in the new case.	✔️

Common errors

Invalid or missing field values

This error occurs when the field values do not match the expected type. For example, this may happen if you selected a number type but entered a string, or if a required value is missing.

Please enter a valid case uuid

This error occurs when an invalid Case UUID is provided. Ensure that you have selected the correct Case UUID for your case.

Error fetching case fields

If you encounter the error “You have not been granted access to this feature or page” when attempting to refresh the Case fields, ensure that the API key you’re using with Plumber has been granted the Admin role.

FAQ

Is there a guide for GatherSG?

Yes. You can find the guide here.

Is GatherSG free to use?

Yes. GatherSG is free to use. You can find more details in the guide.

Who can use GatherSG?

Only users with gov.sg email addresses (excluding defence.gov.sg and mindef.gov.sg).

How do I log in to GatherSG?

Follow the instructions in the guide.

I cannot find the GatherSG option on Plumber

Submit a request using this form and the team will get back to you.