# Ownself Gather

Ownself Gather (OG) 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 OG can be found [here](https://ownself.gather.gov.sg/).

{% hint style="info" %}
When creating your API key on OG to use with Plumber, ensure that you have granted the **Admin** role.

**How to create an API key on OG?**

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.
   {% endhint %}

## Adding a new Ownself Gather connection

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

## Update case

Use this action to update an existing case in OG. 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 | <p>Select the fields and enter the values you want to update.</p><p></p><p><img src="https://2212031742-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXyVsBiX9OwOL1o9g5hLM%2Fuploads%2FNYY865Co10iX3QDSMEOX%2FScreenshot%202025-10-27%20at%205.29.16%E2%80%AFPM.png?alt=media&#x26;token=e87ced9e-a7de-4135-a97c-fc0cff9a7b0b" alt=""></p> |           |

## Tag/untag case

Use this action to add or remove tags from an existing case in OG. Tags help you group and filter cases easily on OG, 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 OG. 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

<details>

<summary>Invalid or missing field values</summary>

<figure><img src="https://2212031742-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXyVsBiX9OwOL1o9g5hLM%2Fuploads%2FpYWJb5clfv89lVJPcJwX%2FScreenshot%202025-10-27%20at%206.16.30%E2%80%AFPM.png?alt=media&#x26;token=dbff9280-5dba-4c67-8d73-65e52af376f5" alt=""><figcaption></figcaption></figure>

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

</details>

<details>

<summary>Please enter a valid case uuid</summary>

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

</details>

<details>

<summary>Error fetching case fields</summary>

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.

</details>

## FAQ

<details>

<summary>Is there a guide for Ownself Gather?</summary>

Yes. You can find the guide [here](https://go.gov.sg/og-user-guide).

</details>

<details>

<summary>Is Ownself Gather free to use?</summary>

Yes. Ownself Gather is free to use. You can find more details in the [guide](https://dcubeux.gitbook.io/ownself-gather#is-it-free-to-use).

</details>

<details>

<summary>Who can use Ownself Gather?</summary>

Ownself Gather is available to all government officers.

|                                                                                                                           | How to sign in?                                                                                                              |
| ------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------- |
| <mark style="color:blue;">gov.sg</mark> email holders                                                                     | Sign in directly using your <mark style="color:blue;">gov.sg</mark> email address.                                           |
| Non-<mark style="color:blue;">gov.sg</mark> users (TIVO, Agencies without <mark style="color:blue;">gov.sg</mark> emails) | Sign up for an account via Singpass, then request a <mark style="color:blue;">gov.sg</mark> officer to add you to their app. |

</details>

<details>

<summary>How do I log in to Ownself Gather?</summary>

Follow the instructions in the [guide](https://dcubeux.gitbook.io/ownself-gather/basic-guide/signup-login).

</details>

<details>

<summary>I cannot find the Ownself Gather option on Plumber</summary>

Submit a request using this [form](https://go.gov.sg/plumber-support) and the team will get back to you.

</details>