---
isPublished: true
knowledgeIndex: false
hidden: true
noindex: true
template: "page.peb"
title: "Multi Document Room Action Flow Reference"
description: "Create or update Room Items from files attached to selected child records."
contentType: "reference"
audience: "admin,developer"
---

# Multi Document Room Action

Create or update Room Items from files attached to selected child records.
The namespaced Apex action name is `rooms__MultiRecordRoomAction`.

## Transaction summary

| Effect | Behavior |
| --- | --- |
| API callout | Room/file synchronization callouts run in queued work after the action step. |
| Record writes | Upserts Room Item records in the calling transaction. When a Site Template is used, Room creation can also write Room, Item, Member or Checklist records. |
| Platform event | The action does not directly publish a platform event. |
| Background work | Yes. It queues synchronization of the selected items. |
| Email | This action does not send recipient email. |

Room ID is used first. If it is blank, Site Template ID can select or create a Room. If both are blank, the action looks for a Room related to the master record. Selected child records must have the configured sharing checkbox enabled.

The action selects the first available File, or the first Attachment when no File is found. Confirm the selected documents before sharing. A record selection with no matches can return Success without adding items.

## Inputs

Required describes the Flow input setting. Additional configuration rules can still require a value.

| API name | Flow label | Required | Default or guidance |
| --- | --- | --- | --- |
| `masterRecordId` | Master Record ID | Yes | Primary source record for the Room. |
| `masterRecordType` | Master Record Type | Yes | Primary object API name, such as `Opportunity`. Keep it consistent with Master Record ID. |
| `childRecordType` | Child Record Type | Yes | Child object API name, such as `Quote`. |
| `childLookupField` | Child Lookup Field | Yes | Child lookup field that refers to the master record. |
| `externalShareField` | Child External Share Field | Yes | Child checkbox field that selects records for external sharing. |
| `itemNameField` | Child Object Item Name Field | No | Exposed input. It does not override item naming in this action. |
| `roomId` | Room ID | No | Use an existing Room. Takes precedence over Site Template ID. |
| `siteId` | Site Template ID | No | Site Template used to obtain or create a Room when Room ID is blank. |
| `enablePreview` | Enable Preview Action on Items | No | Defaults to `false`. Enables item preview where supported. |
| `enableApprove` | Enable Approve Action on Items | No | Defaults to `false`. Enables approval where supported. |
| `enableReject` | Enable Reject Action on Items | No | Defaults to `false`. Enables rejection where supported. |
| `enableESign` | Enable eSign Action on Items | No | Defaults to `false`. Existing File signing metadata can determine the final signing-button setting. |

## Outputs

| API name | Flow label | Meaning |
| --- | --- | --- |
| `Success` | Success | Whether the immediate item preparation and submission succeeded. |
| `Message` | Error Message | Error details. |
| `roomID` | Room ID | The selected or created Room ID when assigned. |

## Configure the Flow

1. Select the master and Room context.
2. Configure the child object, lookup field and external-share checkbox.
3. Review the selected child documents and item actions.
4. Store Success, Message and Room ID.
5. Monitor synchronization before inviting recipients or treating the items as available.

Confirm the Flow user's Apex action access and access to the records or Files used by this operation. Review the configured Salesforce API connection user's access when the action makes an API request.

## Troubleshooting

**No Room context is available.** Supply a valid Room ID, Site Template ID or related master-record Room.

**Success is true but no item appears.** Check the child lookup and sharing checkbox, attached documents and queued-job completion.

**A later callout fails.** This action writes records and queues work in the calling transaction. Review the later action boundary.

See the [Flow action catalog](/content/build/flows/index.md) for related actions and transaction guidance. Confirm that the action and input fields are available in the installed package.
