---
isPublished: true
knowledgeIndex: false
hidden: true
noindex: true
template: "page.peb"
title: "Create Room Flow Action"
description: "Create a Room from a Site Definition and a source Salesforce record."
contentType: "reference"
audience: "admin,developer"
---

# Create Room

Create a Room from a Site Definition and a source Salesforce record.
The namespaced Apex action name is `rooms__CreateRoomAction`.
Check action availability and input fields in your installed package.

## Transaction summary

| Effect | Behavior |
| --- | --- |
| API callout | No immediate API callout. Document generation and Room synchronization are queued when enabled. |
| Record writes | Creates Room, Room Item and owner-member records from the selected template. Updates Room status. Related automation can create further records. |
| Queued work | Yes, when Sync Room with API is true. The immediate result does not confirm document generation. |
| Email | This action does not select a recipient or send a member invitation. |

Supply Site Definition Data ID or Site Definition Name. The ID takes precedence.
Domain Name must be an active registered hostname available to the Salesforce org.
Use the returned Room ID when you add recipients. Wait for required document work before inviting them.

## Inputs

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

| API name | Flow label | Required | Default or guidance |
| --- | --- | --- | --- |
| `recordID` | Record ID | Yes | The source business record. |
| `generateDocs` | Generate all documents | Yes | Default: `true`. Queues document generation when Room synchronization is enabled. |
| `siteDefinitionDataID` | Site Definition Data ID | No | Site Definition Data record ID. Required when Site Definition Name is blank. |
| `siteDefName` | Site Definition Name | No | Alternative Site Definition name. |
| `domainName` | Domain Name | No | Optional registered bare hostname for this Room. |
| `syncRoomAPI` | Sync Room with API (Default=true) | No | Default: `true`. Queues synchronization; set false only when a later step explicitly performs it. |

## Outputs

| API name | Flow label | Meaning |
| --- | --- | --- |
| `success` | Success | Whether Room preparation succeeded. It does not confirm queued work completed. |
| `message` | Error Message (if Success is false) | Preparation error details. |
| `roomID` | Room ID | The created Room ID. |
| `room` | Room | The prepared Room record. |
| `recordID` | Record ID | The source record ID. |
| `siteDefinitionDataID` | Site Definition Data ID | The selected Site Definition Data ID. |
| `generateDocs` | Generate all documents | Compatibility output; it does not measure generated documents. |
| `runAsync` | Run Async (@future) | Compatibility output; it does not confirm completion of queued work. |

## Configure the Flow

1. Select the source record and Site Definition.
2. Set Generate all documents and Sync Room with API for the intended process.
3. Store Success, Error Message and Room ID. Continue only on a successful result.
4. Verify the Room and any queued documents before using an invitation step.

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

**Room or template cannot be found.** Check the Site Definition selector and source record.

**Domain is rejected.** Use a registered bare hostname for this org. Do not supply a full URL.

**Documents are not ready.** The immediate result confirms Room preparation, not completion of queued generation. Inspect the Room and DialogueOne Events before retrying.

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