---
isPublished: true
knowledgeIndex: false
hidden: true
noindex: true
template: "page.peb"
title: "Room Sync Action Flow Action"
description: "Queue document generation and synchronization for an existing Room."
contentType: "reference"
audience: "admin,developer"
---

# Room Sync Action

Queue document generation and synchronization for an existing Room.
The namespaced Apex action name is `rooms__RoomSyncAction`.
Check action availability and input fields in your installed package.

## Transaction summary

| Effect | Behavior |
| --- | --- |
| API callout | No immediate API callout. The queued work makes the callouts. |
| Record writes | No direct business-record write in the action. Queued processing can update documents, Items and member state. |
| Queued work | Yes. Success confirms that the action submitted work, not that work finished. |
| Email | No email is sent directly by this action. |

Use this action after the intended Room, Item and Member records are prepared.
Total Items Generated and Total Members remain zero in the immediate response. They are not completion counts.
Verify the Room and document status before a later step depends on the generated content.

## Inputs

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

| API name | Flow label | Required | Default or guidance |
| --- | --- | --- | --- |
| `roomId` | Room ID | No | Existing Room ID. Required for useful processing although the Flow input is marked optional. |

## Outputs

| API name | Flow label | Meaning |
| --- | --- | --- |
| `roomId` | Room ID | The submitted Room ID. |
| `totalItems` | Total Items Generated | Compatibility output. Remains zero in the immediate response. |
| `totalMembers` | Total Members | Compatibility output. Remains zero in the immediate response. |
| `success` | Success | Immediate submission result; not generation completion. |
| `message` | Error Message | Immediate error details when supplied. |

## Configure the Flow

1. Supply an existing Room ID.
2. Store Success and Error Message.
3. Wait for and verify the required document and synchronization result before delivery.

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

**Success is true but totals are zero.** The immediate result does not contain completion counts.

**Queued work does not complete.** Check the Room, template Files and DialogueOne Events. Avoid submitting the same work repeatedly.

**A later callout fails in the same Flow.** Queued work can leave pending work in the transaction. Review the next callout action's transaction control.

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