---
isPublished: true
knowledgeIndex: false
hidden: true
noindex: true
template: "page.peb"
title: "Room Item Action (Async) Flow Action"
description: "Add a Salesforce File to a Room using the compatibility action without outputs."
contentType: "reference"
audience: "admin,developer"
---

# Room Item Action (Async)

Add a Salesforce File to a Room using the compatibility action without outputs.
The namespaced Apex action name is `rooms__RoomItemCreateAction`.
Check action availability and input fields in your installed package.

## Transaction summary

| Effect | Behavior |
| --- | --- |
| API callout | No immediate API callout. Room synchronization is queued. |
| Record writes | Inserts Room Item records and can update Room status. Errors can create DialogueOne Event records. |
| Queued work | Yes, for Room synchronization. The label does not mean that all record writes happen later. |
| Email | No email is sent. |

The action writes Item records in the calling Flow transaction despite its Async label.
Supply Room ID and Content Version ID or Content Document ID. Content Version ID takes precedence.
Merge Document with Record is retained but does not start document generation in this action.
Use [Add Room Item Action](/content/build/flows/RoomItemAction.md) when the Flow needs the created Item and error outputs.

## Inputs

**Required** describes the Flow input setting. The processing rules above also apply.

| API name | Flow label | Required | Default or guidance |
| --- | --- | --- | --- |
| `masterRecordId` | Master Record ID | No | Retained compatibility input; it is not used to merge a document here. |
| `roomId` | Room ID | No | Required for processing. Existing Room ID. |
| `contentDocumentID` | Content Document ID | No | Salesforce File ID. Used when Content Version ID is blank. |
| `contentVersionID` | Content Version ID | No | Exact File version ID. Takes precedence over Content Document ID. |
| `mergeDocument` | Merge Document with Record | No | Default: `false`. Retained compatibility input; it does not request generation in this action. |

## Outputs

This action returns no Flow outputs. Connect its Fault path and verify the resulting records or delivery separately.

## Configure the Flow

1. Select the Room and File.
2. Connect the Fault path.
3. Inspect the Room Item and synchronization result before continuing.

Review the Flow context, Apex action access and the object and field permissions needed by this operation.
Record writes can run other Salesforce automation.
For API work, also review the configured Salesforce API connection user's required access.

## Troubleshooting

**No Item or output appears.** This action returns no outputs. Inspect the Room and DialogueOne Events.

**Merge Document has no effect.** This compatibility input does not start generation. Use an appropriate generation action.

**A later callout fails.** Item and Room writes occur now; review the later action transaction boundary.

See the [Flow action index](/content/build/flows/index.md) for transaction guidance and related actions.
