View as Markdown
Trello icon

Trello ACTION

Create a Board

Create a new Trello board or copy from an existing one. See the documentation.
  • Action
  • Writes data
  • OAuth
  • SDK
  • MCP

IMPLEMENTATION

Call this tool

Connect a user's Trello account once, then configure and run Create a Board 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: "trello-create-board",
  externalUserId: "{external_user_id}", // any stable ID for this user in your system
  configuredProps: {
    trello: { authProvisionId: "apn_xxxxxxx" },
    name: "Name",
    defaultLabels: true,
  },
})

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 Board inputs
Property Type Description
name Name string
The new name for the board. 1 to 16384 characters long.
Required
defaultLabels Default Labels boolean
Determines whether to use the default set of labels.
Optional
defaultLists Default Lists boolean
Determines whether to add the default set of lists to a board (To Do, Doing, Done). It is ignored if idBoardSource is provided.
Optional
desc Description string
A new description for the board, 0 to 16384 characters long
Optional
idOrganization Organization ID string
The id or name of the team the board should belong to.
Required Dynamic
idBoardSource Board Source ID string
The id of a board to copy into the new board.
Optional Dynamic
keepFromSource Keep From Source string
To keep cards from the original board pass in the value cards.
Optional
powerUps Power-Ups string
The Power-Ups that should be enabled on the new board. One of: all, calendar, cardAging, recap, voting.
Optional
prefsPermissionLevel Prefs Permission Level string
The permissions level of the board. One of: org, private, public.
Optional
prefsVoting Prefs Voting string
Who can vote on this board. One of disabled, members, observers, org, public.
Optional
prefsComments Prefs Comments string
Who can comment on cards on this board. One of: disabled, members, observers, org, public.
Optional
prefsInvitations Prefs Invitations string
Determines what types of members can invite users to join. One of: admins, members.
Optional
prefsSelfJoin Prefs Self Join boolean
Determines whether users can join the boards themselves or whether they have to be invited.
Optional
prefsCardCovers Prefs Card Covers boolean
Determines whether card covers are enabled.
Optional
prefsBackground Prefs Background string
The id of a custom background or one of: blue, orange, green, red, purple, pink, lime, sky, grey.
Optional
prefsCardAging Prefs Card Aging string
Determines the type of card aging that should take place on the board if card aging is enabled. One of: pirate, regular.
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
trello-create-board
Version
0.2.8
App
Trello
Authentication
OAuth
Read-only
No
Destructive
No
Open world
Yes