# Pipe settings

<details>

<summary>Collaborators</summary>

### Adding a collaborator

You can add existing Plumber users as an **Editor** or **Viewer** to your Pipe.&#x20;

<figure><img src="https://2212031742-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXyVsBiX9OwOL1o9g5hLM%2Fuploads%2F4tJUyq1MszQTT0fZUmV9%2FScreenshot%202025-11-19%20at%205.10.13%E2%80%AFPM.png?alt=media&#x26;token=c4a57acf-5c8b-469c-be9a-8c7421e91086" alt=""><figcaption></figcaption></figure>

<table><thead><tr><th width="323.87890625"></th><th>Editor</th><th>Viewer</th></tr></thead><tbody><tr><td>View Pipe</td><td>✔️</td><td>✔️</td></tr><tr><td>Modify Pipe</td><td>✔️</td><td></td></tr><tr><td>Publish / unpublish Pipe</td><td>✔️</td><td></td></tr><tr><td>View Executions</td><td>✔️</td><td>✔️</td></tr><tr><td>Retry failed Executions</td><td>✔️</td><td></td></tr><tr><td>Modify collaborators</td><td>✔️</td><td></td></tr><tr><td>Select connections already added in the pipe</td><td>✔️</td><td></td></tr><tr><td>Add / select new connections</td><td>Coming soon!</td><td></td></tr></tbody></table>

#### Connections-related information

<table><thead><tr><th width="193.49609375">App</th><th>Description</th></tr></thead><tbody><tr><td>ALL</td><td>Editors are only able to use existing connections added by the owner.</td></tr><tr><td>FormSG</td><td>Collaborators will not be able to verify this connection unless the form is shared with them. This is optional as the pipe will still work normally.</td></tr><tr><td>Tiles</td><td>Pipe collaborators are automatically added as collaborators to Tiles used in the pipe.</td></tr><tr><td>Excel</td><td>Collaborators will not be able to access the Excel file unless explicitly shared with them.</td></tr></tbody></table>

</details>

<details>

<summary>Transfer Pipe</summary>

### Step 1: Making the transfer

1. Enter the email address you wish to transfer the pipe to. (**They'll have to login at least once for this feature to work.)**
2. Click on "Transfer Pipe".
3. Click on "Yes, transfer pipe" if the email address has been entered correctly.
4. A message indicating the pipe has been transferred will be shown (screenshot below).

<figure><img src="https://2212031742-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXyVsBiX9OwOL1o9g5hLM%2Fuploads%2FwPcbGHItp2z7U6FUZRWp%2Fimage.png?alt=media&#x26;token=de5df2b0-f19a-4eed-8ae0-9ac94db52ad3" alt=""><figcaption></figcaption></figure>

Your pipe is now pending transfer. Get your colleague to double check the pipe connections and actions.

* You will need to **manually pass over the permissions and credentials** for each connection involved e.g. **FormSG** would involve you handing ownership or editor rights of the form to the receiving user and passing of the secret key as well. **M365 excel** will require the receiving user to be granted the right permissions and access to the file involved.
* If you accidentally made a transfer request to the wrong user, you can click on "cancel" to retract it.
* The process is only completed once your colleague accepts the pipe transfer on their account.

### Step 2: Accepting a Pipe transfer

1. Receiving user will need to login to [Plumber](https://plumber.gov.sg/) and accept the transfer.
2. A prompt will appear on the receiver's account as seen in the screenshot below.<br>

   <figure><img src="https://2212031742-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXyVsBiX9OwOL1o9g5hLM%2Fuploads%2F0P3PPuWmH1SDSNiC0FI7%2Fimage.png?alt=media&#x26;token=1fba1750-248a-4595-b399-d2e3a8f52966" alt=""><figcaption></figcaption></figure>
3. Click on "View and accept".
4. You'll be brought to another page to accept or reject the trasnfer.
5. Ensure that you reconnect all connections and check all steps in the pipe to ensure that everything works well. If there are no connections involved, you should be able to immediately publish the pipe and it will still work as intended.

</details>

<details>

<summary>Email notifications</summary>

<figure><img src="https://2212031742-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXyVsBiX9OwOL1o9g5hLM%2Fuploads%2Fs9hIfXKi5Rjs9VZetBWw%2FScreenshot%202025-11-19%20at%205.23.08%E2%80%AFPM.png?alt=media&#x26;token=2c8e290f-2ae8-4cf2-9216-28542097227f" alt=""><figcaption></figcaption></figure>

This is where you customise the frequency of receiving error notifications from us. Choose from these options:

| Option                                                   |                                                                                                                                                                |
| -------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| First error on this pipe, one email notification per day | When the first error on your pipe for that day is detected, we send an email to you. No emails will be sent for subsequent errors that happen on the same day. |
| Each error on this pipe                                  | Whenever there is an error, we send an email to you. For e.g. 100 errors = 100 emails                                                                          |

When the Pipe has been shared with collaborators, you can choose to notify them of any errors by selecting the relevant checkboxes:

<figure><img src="https://2212031742-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXyVsBiX9OwOL1o9g5hLM%2Fuploads%2Fg3onhd5vTbAX3Pu9vH6J%2FScreenshot%202025-11-19%20at%205.19.30%E2%80%AFPM.png?alt=media&#x26;token=b9b6f40e-5448-4c94-9955-e7da0b031aff" alt=""><figcaption></figcaption></figure>

</details>