Create Bluebeam Session

The Create Bluebeam Session node is used to programmatically create a Bluebeam Studio Session and upload one or more documents, inviting specified users to collaborate.

This node is typically used in scenarios where project files need to be reviewed, marked up, or signed off in a structured session with multiple participants using Bluebeam Revu.

---

🧩 Node Type

Task – Executes backend logic on the API server to create the Bluebeam session and configure access.

---

⚙️ Required Inputs

Label	Description	Type	Example
Session Name	The name of the Bluebeam session to create.	Text	"Structural Review - June 2025"
File Paths	A list of full file paths (local to the server) to upload into the session.	Array	["C:\Projects\Review1.pdf"]
Users	A list of user emails to invite to the session. Supports variable expansion or nested arrays.	Array	["email1@example.com", "email2@example.com"]

---

📤 Output

Output Key	Description
Session Id	The unique identifier for the created Bluebeam session.

The Session Id is stored into the taskParameters.data object for downstream node use.

---

🔄 Internal Logic Summary

1. Input Validation Validates that Session Name, File Paths, and Users are provided and not empty.

2. User Resolution The node supports:

   • Single emails
   • Arrays of emails
   • Placeholder replacement using the automation context Duplicates and empty strings are removed.

3. File Resolution Handles nested arrays and placeholders similarly to users. Verifies that each resolved file exists on disk before proceeding.

4. Session Creation

   • The session name
   • The cleaned list of users
   • The cleaned list of file paths

5. Error Handling Returns detailed error messages for:

   • Missing or invalid parameters
   • Missing local files
   • Errors returned by the Bluebeam service

---

🛑 Failure Scenarios

Scenario	Result
Missing session name, users, or files	Task fails with Required Parameters not found
One or more file paths do not exist	Task fails with Local File Not found
Bluebeam service error	Task fails with Failed to create session. Message: <error>

---

📝 Notes

• Ensure file paths are accessible to the API server, not client paths.
• If Users input contains placeholders or nested arrays, they are automatically flattened and resolved.
• The session is created using Bluebeam’s Studio Session feature.

---

📌 Example Use Case

A construction review workflow includes a task node that uploads several PDF drawings and invites structural engineers and architects to collaborate on markups. This node allows for automated session creation, reducing manual admin work.

---