View as Markdown
Pencil Spaces icon

Pencil Spaces ACTION

Create A Space

Create a new space in Pencil Spaces. See the documentation
  • Action
  • Writes data
  • API key
  • SDK
  • MCP

IMPLEMENTATION

Call this tool

Connect a user's Pencil Spaces account once, then configure and run Create A Space 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: "pencil_spaces-create-space",
  externalUserId: "{external_user_id}", // any stable ID for this user in your system
  configuredProps: {
    pencil_spaces: { authProvisionId: "apn_xxxxxxx" },
    title: "Title",
    spaceToCloneId: "Space To Clone Id",
  },
})

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 A Space inputs
Property Type Description
title Title string
The title of the Space. If not provided and Space To Clone Id is set, the existing Space name will be used. If not, a random Space name will be generated.
Optional
spaceToCloneId Space To Clone Id string
The space ID of the Space you want to clone. You may only clone Spaces that are templates, Spaces for which you are a host, and Spaces which you can access as an admin due to your institution settings.
Optional Dynamic
ownerId Owner Id string
The ID of the user who will be the owner of the space. If not provided, the current user will be the owner.
Optional Dynamic
hostIds Host Ids string[]
The hosts you wish to invite to the Space. The user associated with your API key will always be added as a host.
Optional Dynamic
participantIds Participant Ids string[]
The participants you wish to invite to the Space.
Optional Dynamic
visibility Visibility string
The visibility of the Space.
Optional
notifyInvitees Notify Invitees boolean
Whether you want to automatically notify invitees when you create your Space.
Required
siteId Site Id string
The ID of the site you want to create the Space in.
Optional Dynamic

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
pencil_spaces-create-space
Version
0.0.2
App
Pencil Spaces
Authentication
API key
Read-only
No
Destructive
No
Open world
Yes