# MoneyThumb Briefcase MoneyThumb Briefcase is in beta. If you want to access it, please contact [MoneyThumb Support](https://www.moneythumb.com/support/). ## What is Briefcase MoneyThumb Briefcase is a secure, in-platform application sharing network on PDF Insights that connects brokers and funders. Briefcase allows sharing and receiving of applications quickly by trusted connections. So, you can collaborate directly with your partners using our platform. There are two parties in a Briefcase connection: Sender and Receiver. **Who is a Sender:** A sender is any user who shares applications with connections. **Who is a Receiver:** A receiver is any user who accepts applications from connections. ### Enabling Briefcase To enable Briefcase: 1. Go to **Company Settings**. 2. Select **Briefcase Settings** and click the **Enable Briefcase** box. img 1. When the Congrats screen appears, add your company name and click **Add Connections**. img 1. Fill out your information in the following fields: * **Briefcase Connection Emails**: Allows connection invitations sent to the following email addresses to be accepted or rejected. Recommended for both UI or API usage. * **Briefcase Sharing Emails:** Notifies the following email addresses when applications are shared with you or status updates for the applications you have shared with connections. Recommended for UI usage. * **Briefcase Webhook URLs:** Triggers a webhook call when applications are shared with you or status updates for the applications you have shared with connections. Required for API usage. 2. Click **Save**. ### Underwriter Permissions (Admins Only) Once you enable Briefcase, all underwriters have sharing access by default. To restrict a specific underwriter: 1. Open **Underwriter Settings** and edit the permission. 2. Navigate to the **Briefcase Sharing** tab. 3. Uncheck the **Briefcase Sharing** checkbox. This prevents that underwriter from sharing applications with connected Receivers. ### Establishing Briefcase Connections Only Administrators can send, accept, or reject Briefcase connection invitations. If you’re an administrator: 1. Go to **Company Settings**. 2. Select **Briefcase Connections**. 3. Enter the desired email address. 4. If you're the sender, click **Request to Send**. If you're the receiver, click **Request to Receive**. ### Viewing Briefcase Connections You can either view a Briefcase connection from [Insights UI](https://insights.moneythumb.com/) or from Insights API. #### From Insights UI: In **Company Settings** under the **Briefcase Connections** tab, the connections table displays all active connections, including each connection's name, sharing direction (Sender or Recipient), and status. From this table, you can also delete active connections. 🔎 Here's an example of viewing a Briefcase connection. img #### From Insights API: The [`GET /briefcase/connections`](https://docs.moneythumb.com/api/pdf-insights/api-reference/other/connections) endpoint returns an array of all connections. Each record includes: * `inviterPartyKey` * `inviterPartyName` * `connectedPartyKey` * `connectedPartyName` * `direction` * `status` * `proposedDateTime` * `responseDateTime` ⚠️ **Important:** To send applications via the API, you need `connectedPartyKey`. ### Sharing a Briefcase Application You can either share an application in Briefcase from [Insights UI](https://insights.moneythumb.com/) or from Insights API. #### From Insights UI: 1. Create or open any application. 2. Locate the **Share** button in the upper-right. When the popup appears listing your active Recipient connections, select one or more and confirm to send the offer. Once you share the application, the **Share** button becomes **Sharing** with a notification. If you hover over the button, you can see its status. 🔎 Here's an example. img Receivers configured with email or webhook notifications will be alerted immediately. The Insights UI users can see a notification on the Home Page, indicating pending incoming shares. #### Opening a Shared Briefcase Application The **Briefcase Applications** tab appears on the Home Page. This shows the applications that are in Briefcase. As the receiver party, when applications are shared, this tab populates. 🔎 Here's an example. img When you click **Open App**, you open the application of the receiver party. The **Share** button at the top becomes **Shared App**. img This shows the application was shared to you by the receiving party. #### Using Insights API 1. Authenticate to PDF Insights via the [`/authenticate`](https://docs.moneythumb.com/api/pdf-insights/api-reference/other/authenticate) endpoint. 2. Use the [`/briefcase/connections`](https://docs.moneythumb.com/api/pdf-insights/api-reference/other/connections) endpoint to retrieve the `partyIds` needed to share applications. 3. Call [`POST /briefcase/share`](https://docs.moneythumb.com/api/pdf-insights/api-reference/other/share) with the `appId` and the array of `partyIds`, representing the desired Receivers, to share the application. Insights API initiates a share with each specified party and triggers any configured email or webhook notifications on the Receiver's end. ### Receiving Status Updates—Receiver When a new application or [application update](#accept-updates) has been shared with you, an update will be sent to the **Briefcase Sharing Emails** or **Webhook** saved in the **Company Settings**. On the Insights Home Page, a notification icon appears on the **Briefcase Applications** tab. ### Accepting a Briefcase Application You can either accept an application in Briefcase from [Insights UI](https://insights.moneythumb.com/) or from Insights API. #### Using Insights UI A notification on the **Briefcase Applications** tab of the Home Page shows the number of pending incoming shares. Clicking the tab displays the list of offered applications with preview fields. You can either **Accept** or **Decline** the application. Accepted applications create a new application in your account with all of the data shared automatically processed. #### Using Insights API 1. Authenticate to PDF Insights via the [`/authenticate`](https://docs.moneythumb.com/api/pdf-insights/api-reference/other/authenticate) endpoint. 2. Call [`POST /briefcase/respond`](https://docs.moneythumb.com/api/pdf-insights/api-reference/other/respond) with * The `shareKey` (returned as part of the Webhook notification). * A response of `ACCEPT` or `DECLINE`. * Optionally, an appNumber for the new application. 3. If accepted, Insights API copies the application into the Receiver's account and returns the new application ID. A `shareKey` that starts with `S-` indicates the share is a new application. ### Receiving Status Updates—Sender Once the Recipient accepts or declines an application, an update is sent to the **Briefcase Sharing Emails** or **Webhook** saved in the **Company Settings**. In the UI, you can view application-specific status updates by opening the **Share** button to see Pending, Accepted, or Declined shares. ### Adding Updates to a Briefcase Application You can either add an application in Briefcase from [Insights UI](https://insights.moneythumb.com/) or from Insights API. #### Using Insights UI When new documents are added to an already-shared application, an orange circle appears on the **Sharing** button. An **Update Needed** notification appears to prompt sharing the update with all of the Receivers. The Receiver sees a notification that new documents have been shared with the option to accept or decline the documents. If a Receiver hasn't accepted an application before an update is shared, they receive all current documents upon acceptance. #### Using Insights API Call [`POST /briefcase/update`](https://docs.moneythumb.com/api/pdf-insights/api-reference/other/update) with the `appId` or `appNumber` of the previously shared application. Insights API pushes the update to all Receivers who have already accepted. It also modifies the pending offer for those who have not yet responded. This triggers configured email and webhook notifications just like initial shares. ### Accepting Updates to an Application You can either update an application in Briefcase from [Insights UI](https://insights.moneythumb.com/) or from Insights API. #### Using Insights UI Within a shared application, a notification appears on the **Shared App** button that indicates there are new documents from the Sender. By clicking on **Shared App**, you can either accept or reject the updated documents. #### Using Insights API 1. Authenticate to PDF Insights via the [`/authenticate`](https://docs.moneythumb.com/api/pdf-insights/api-reference/other/authenticate) endpoint. 2. Call [`POST /briefcase/respond`](https://docs.moneythumb.com/api/pdf-insights/api-reference/other/respond) with * The `shareKey` (returned as part of the Webhook notification). * A response of `ACCEPT` or `DECLINE`. * Optionally, an `appNumber` for the new application. 3. If accepted, Insights API copies the application into the Receiver's account and returns the new application ID. A `shareKey` that starts with `U-` indicates the share is an update to a previously shared application. ### Viewing History of Briefcase applications You can view the history all applications shared in Briefcase using the Insights API. #### Using Insights API 1. Authenticate to PDF Insights via the [`/authenticate`](https://docs.moneythumb.com/api/pdf-insights/api-reference/other/authenticate) endpoint. 2. Call [`GET /briefcase/history`](/api/pdf-insights/api-reference/other/history).