View as Markdown
WorkFlowy icon

WorkFlowy ACTION

Create Node

Creates a new bullet node in WorkFlowy via the beta API (POST /api/v1/nodes). Use this to add a top-level node or a child under an existing parent. To create a child node, first run Search Nodes to obtain a valid parent node ID and pass it as parentNodeId. Returns the newly created node's ID. See the documentation.
  • Action
  • Writes data
  • API key
  • SDK
  • MCP

IMPLEMENTATION

Call this tool

Connect a user's WorkFlowy account once, then configure and run Create Node 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: "workflowy-create-node",
  externalUserId: "{external_user_id}", // any stable ID for this user in your system
  configuredProps: {
    workflowy: { authProvisionId: "apn_xxxxxxx" },
    name: "Name",
    note: "Note",
  },
})

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 Node inputs
Property Type Description
name Name string
The main text of the node.
Required
note Note string
Optional note (secondary text) for the node.
Optional
parentNodeId Parent Node ID string
Free-form parent node ID under which to create this node. Leave blank to create a top-level node. To find a valid ID, first run Search Nodes and copy the id of the desired parent. Also accepts special values: None (root), inbox, calendar, today, tomorrow, next_week, or a date like YYYY-MM-DD.
Optional
layoutMode Layout Mode string
Optional display mode for the node. One of: bullets, todo, h1, h2, h3, code-block, quote-block.
Optional
position Position string
Where to place the node among its siblings. One of top (default) or bottom.
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
workflowy-create-node
Version
0.0.2
App
WorkFlowy
Authentication
API key
Read-only
No
Destructive
No
Open world
Yes