View as Markdown
Mural icon

Mural ACTION

Create Room

Create a new room to group related murals within a workspace. Choose an open room to let any workspace member join, or a private room to restrict access to invited members only. Confidential rooms add a further layer of security but are Enterprise-only and cannot have share links. Requires the rooms:write OAuth scope. See the documentation
  • Action
  • Writes data
  • OAuth
  • SDK
  • MCP

IMPLEMENTATION

Call this tool

Connect a user's Mural account once, then configure and run Create Room from your backend or agent.

import { PipedreamClient } from "@pipedream/sdk"

const pd = new PipedreamClient({
  projectId: process.env.PIPEDREAM_PROJECT_ID!,
  clientId: process.env.PIPEDREAM_CLIENT_ID!,
  clientSecret: process.env.PIPEDREAM_CLIENT_SECRET!,
  projectEnvironment: "production",
})

const result = await pd.actions.run({
  id: "mural-create-room",
  externalUserId: "{external_user_id}", // any stable ID for this user in your system
  configuredProps: {
    mural: { authProvisionId: "apn_xxxxxxx" },
    workspaceId: "Workspace ID",
    name: "Name",
  },
})

console.log(result)

SCHEMA

Inputs

Pipedream supplies the connected account. Your application provides the operation-specific values below. Dynamic inputs are resolved against that user's account.

Create Room inputs
Property Type Description
workspaceId Workspace ID string
The ID of the Workspace.
Required Dynamic
name Name string
The name of the room
Required
type Type string
When set to open, any member of a workspace may join the room. When set to private, only members that are invited may join the room.
Required
description Description string
The description of the room
Optional
confidential Confidential boolean
When true, the room will be marked as confidential. Confidential rooms are for enterprise customers only.
Optional

REFERENCE

Tool details

Behavior hints are published with the component in the Pipedream registry and surface as MCP tool annotations, so an agent can reason about a tool before it calls it.

Registry key
mural-create-room
Version
0.0.2
App
Mural
Authentication
OAuth
Read-only
No
Destructive
No
Open world
Yes