View as Markdown
Notion (API Key) icon

Notion (API Key) ACTION

Append Block to Parent

Append new and/or existing blocks to the specified parent. See the documentation
  • Action
  • Writes data
  • API key
  • SDK
  • MCP

IMPLEMENTATION

Call this tool

Connect a user's Notion (API Key) account once, then configure and run Append Block to Parent 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: "notion_api_key-append-block",
  externalUserId: "{external_user_id}", // any stable ID for this user in your system
  configuredProps: {
    notion_api_key: { authProvisionId: "apn_xxxxxxx" },
    pageId: "Parent Block ID",
    blockTypes: ["Block Type(s)"],
  },
})

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.

Append Block to Parent inputs
Property Type Description
pageId Parent Block ID string
Select a parent block/page or provide its ID
Required Dynamic
blockTypes Block Type(s) string[]
Select which type(s) of block you'd like to append
Required
blockIds Existing Block IDs string[]
Select one or more block(s) or page(s) to append (selecting a page appends its children). You can also provide block or page IDs.
Required Dynamic
markdownContents Markdown Contents string[]
Each entry is the content of a new block to append, using Markdown syntax. See the documentation for more information
Required
imageUrls Image URLs string[]
One or more Image URLs to append new image blocks with. See the documentation for more information
Required

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
notion_api_key-append-block
Version
0.0.3
App
Notion (API Key)
Authentication
API key
Behavior
May modify external data