---
isPublished: true
knowledgeIndex: false
hidden: true
noindex: true
template: "page.peb"
title: "Document Room Action Flow Action"
description: "Create an ordinary Room from a Site Definition using the compatibility action."
contentType: "reference"
audience: "admin,developer"
---

# Document Room Action

Create an ordinary Room from a Site Definition using the compatibility action.
The namespaced Apex action name is `rooms__RoomCreateAction`.
Check action availability and input fields in your installed package.

## Transaction summary

| Effect | Behavior |
| --- | --- |
| API callout | No immediate API callout. Requested document merge and Room synchronization are queued. |
| Record writes | Creates Room, Item and owner-member records, then updates Room status and Next Action. Merge preparation can create error Events. |
| Queued work | Yes. Requested document work and synchronization continue later. |
| Email | No recipient invitation is sent directly by this action. |

This compatibility action does not return Room outputs. For a new Flow that needs the created Room ID, use [Create Room](/content/build/flows/CreateRoomAction.md).
Supply Site Definition Data ID or Site Definition Name. The ID takes precedence.
Generate all documents requests merge work. The action does not wait for completion.

## 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 | Yes | The source business record. |
| `siteDefinitionDataId` | Site Definition Data ID | No | Site Definition Data ID. Required when Site Definition Name is blank. |
| `siteDefName` | Site Definition Name | No | Alternative Site Definition name. |
| `generateDocs` | Generate all documents | No | Default: `true`. Requests asynchronous document merges. |
| `nextAction` | Next Action | No | Optional value saved on the Room for subsequent Flow processing. |
| `roomId` | Room ID (Deprecated) | No | Deprecated. Do not use to select an existing Room. |
| `generateItems` | Provision document items from portal template | No | Default: `true`. Retained compatibility input; it does not change current template provisioning. |
| `siteDefId` | Portal Metadata ID (Deprecated) | No | Deprecated. Use Site Definition Data ID instead. |

## 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 source record and Site Definition.
2. Choose whether document generation is needed.
3. Connect the Fault path. Inspect the created Room and queued work before inviting a recipient.

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

**Creation fails.** Check the source record and Site Definition selector. Read the Fault message.

**The Flow needs Room ID.** Use Create Room instead of this compatibility action.

**A retained input has no effect.** Room ID and Portal Metadata ID are deprecated. Provision document items is retained but does not change the current template-build behavior.

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