PLANKA

App · 37 actions

Keep your PLANKA boards moving without opening them: turn emails, form responses and tickets into cards, move cards between lists, add labels, members, checklists, comments and files, and send a summary of a board. Start a workflow when a card is created or moved, someone comments, a task is ticked off or a card is due.

Actions

ActionWhat it does
Add commentComment on a card, as the person the connection acts as.
Add label to cardPut one of the board's labels on a card.
Add member to cardAdd a member of the board to a card, such as whoever is on call.
Add taskAdd a task to a card's task list.
Add task listAdd a task list (a checklist) to a card.
Attach file to cardAttach a file, such as an email's attachment or a generated report, to a card.
Attach link to cardAttach a link, such as the document or ticket a card is about, to a card.
Create boardAdd a board to a project, after its other boards.
Create cardAdd a card to a list, such as one for each new form response or email, with a description and a due date.
Create labelAdd a label, such as Urgent, to a board.
Create listAdd a list, such as To do or Done, to a board.
Create projectStart a project, such as one for each new client.
Delete attachmentDelete a file or link from its card.
Delete boardDelete a board for good, with its lists, cards, comments and attachments.
Delete cardDelete a card for good, with its comments, tasks and attachments.
Delete commentDelete a comment.
Delete listDelete a list from a board.
Delete projectDelete a project.
Delete taskDelete a task from its task list.
Delete task listDelete a task list from a card, with its tasks.
Duplicate cardCopy a card, such as a template card, with its description, labels, members, task lists and attachments, to the end of its list.
Get boardGet a board with its lists, labels, members and cards, such as for a weekly summary of what's in each list.
Get cardGet a card with its list, labels, members, due date, task lists and attachments.
Get projectGet a project with its boards.
List attachmentsList the files and links attached to a card.
List boardsList the boards the connection can see, in one project or in all of them.
List cardsList a board's cards in the board's order: all of them, or those in one list, with one label, given to one person, or with certain words.
List commentsList a card's comments, newest first.
List labelsList a board's labels.
List peopleList the people in PLANKA, to find who to add to a card.
List projectsList the projects the connection can see, with how many boards each has.
Move cardMove a card to another list, such as Done, on its own board or another.
Remove label from cardTake a label off a card.
Remove member from cardTake a person off a card.
Update cardChange a card's title, description or due date, or tick its due date as done.
Update listRename a list, move it first or last on its board, or change whether its cards count as done.
Update taskTick a task off or untick it, rename it, or give it to someone.

Add comment

Comment on a card, as the person the connection acts as.

Inputs

CardcardtextRequired
The card: its ID from another PLANKA step or a trigger, or its link in PLANKA.
CommenttexttextRequired
What the comment says. PLANKA shows Markdown formatted.

Outputs

card_idtext
The ID of the card it's on
created_attext
When it was written
idtext
The comment's ID, which 'Delete comment' takes
texttext
What it says
user_idtext
The ID of the person who wrote it
user_nametext
Their name
Example output
{
  "card_id": "1909958737779491858",
  "created_at": "2026-11-03T14:05:00.000Z",
  "id": "1909958739314607138",
  "text": "Needs a shorter headline.",
  "user_id": "1909958735514567684",
  "user_name": "Riley Chen"
}

Add label to card

Put one of the board's labels on a card.

Inputs

CardcardtextRequired
The card: its ID from another PLANKA step or a trigger, or its link in PLANKA.
LabellabeltextRequired
One of the labels of the card's board: pick one, or give its ID or its name, such as Urgent.

Outputs

addedtrue/false
Whether the label was added: false when the card already had it
board_idtext
The ID of the board it's on
board_nametext
That board's name
closedtrue/false
Whether it's in a closed list, so counts as done
comments_totalnumber
How many comments it has
created_attext
When it was created
descriptiontext
Its description
due_completedtrue/false
Whether its due date is ticked as done
due_datetext
When it's due, blank when it has no due date
idtext
The card's ID, which other PLANKA steps take
label_idtext
The label's ID
label_idslist
The IDs of its labels
labelslist
The names of its labels
linktext
Where the card opens in PLANKA
list_idtext
The ID of the list it's in
list_nametext
That list's name, such as Doing
member_idslist
The IDs of the people on it
memberslist
The names of the people on it
nametext
The card's title
positionnumber
Where it sits in its list
tasks_completednumber
How many of them are ticked off
tasks_totalnumber
How many tasks it has
updated_attext
When it was last changed
Example output
{
  "added": true,
  "board_id": "1909958735917220871",
  "board_name": "Launch plan",
  "closed": false,
  "comments_total": 2,
  "created_at": "2026-11-02T09:20:00.000Z",
  "description": "Headline, three sections and a call to action.",
  "due_completed": false,
  "due_date": "2026-11-19T17:00:00.000Z",
  "id": "1909958737779491858",
  "label_id": "1909958736697361423",
  "label_ids": [
    "1909958736697361423"
  ],
  "labels": [
    "Urgent"
  ],
  "link": "https://planka.example.com/cards/1909958737779491858",
  "list_id": "1909958736303096844",
  "list_name": "To do",
  "member_ids": [
    "1909958735514567684"
  ],
  "members": [
    "Riley Chen"
  ],
  "name": "Write homepage copy",
  "position": 65536,
  "tasks_completed": 1,
  "tasks_total": 3,
  "updated_at": "2026-11-03T14:05:00.000Z"
}

Add member to card

Add a member of the board to a card, such as whoever is on call.

Inputs

CardcardtextRequired
The card: its ID from another PLANKA step or a trigger, or its link in PLANKA.
PersonusertextRequired
A member of the card's board: pick one, or give their ID, username, email or name.

Outputs

addedtrue/false
Whether they were added: false when they were already on the card
board_idtext
The ID of the board it's on
board_nametext
That board's name
closedtrue/false
Whether it's in a closed list, so counts as done
comments_totalnumber
How many comments it has
created_attext
When it was created
descriptiontext
Its description
due_completedtrue/false
Whether its due date is ticked as done
due_datetext
When it's due, blank when it has no due date
idtext
The card's ID, which other PLANKA steps take
label_idslist
The IDs of its labels
labelslist
The names of its labels
linktext
Where the card opens in PLANKA
list_idtext
The ID of the list it's in
list_nametext
That list's name, such as Doing
member_idslist
The IDs of the people on it
memberslist
The names of the people on it
nametext
The card's title
positionnumber
Where it sits in its list
tasks_completednumber
How many of them are ticked off
tasks_totalnumber
How many tasks it has
updated_attext
When it was last changed
user_idtext
The person's ID
Example output
{
  "added": true,
  "board_id": "1909958735917220871",
  "board_name": "Launch plan",
  "closed": false,
  "comments_total": 2,
  "created_at": "2026-11-02T09:20:00.000Z",
  "description": "Headline, three sections and a call to action.",
  "due_completed": false,
  "due_date": "2026-11-19T17:00:00.000Z",
  "id": "1909958737779491858",
  "label_ids": [
    "1909958736697361423"
  ],
  "labels": [
    "Urgent"
  ],
  "link": "https://planka.example.com/cards/1909958737779491858",
  "list_id": "1909958736303096844",
  "list_name": "To do",
  "member_ids": [
    "1909958735514567684"
  ],
  "members": [
    "Riley Chen"
  ],
  "name": "Write homepage copy",
  "position": 65536,
  "tasks_completed": 1,
  "tasks_total": 3,
  "updated_at": "2026-11-03T14:05:00.000Z",
  "user_id": "1909958735514567684"
}

Add task

Add a task to a card's task list.

Inputs

CardcardtextRequired
The card: its ID from another PLANKA step or a trigger, or its link in PLANKA.
TasknametextRequired
What the task says.
Task listtask_listtext
The task list to add it to (its name or ID). Leave blank for the card's first one; a card with none gets one called Tasks.

Outputs

assignee_idtext
The ID of the person it's given to, blank for nobody
card_idtext
The ID of the card it's on
completedtrue/false
Whether it's ticked off
idtext
The task's ID, which other PLANKA steps take
nametext
What the task says
task_list_idtext
The ID of the task list it's in
task_list_nametext
The name of the task list it was added to
Example output
{
  "assignee_id": "",
  "card_id": "1909958737779491858",
  "completed": false,
  "id": "1909958740077970472",
  "name": "Review",
  "task_list_id": "1909958739624985637",
  "task_list_name": "Checklist"
}

Add task list

Add a task list (a checklist) to a card.

Inputs

CardcardtextRequired
The card: its ID from another PLANKA step or a trigger, or its link in PLANKA.
NamenametextRequired
What to call the task list, such as Checklist.

Outputs

card_idtext
The ID of the card it's on
idtext
The task list's ID, which other PLANKA steps take
nametext
The task list's name
taskslist
Its tasks, in order
Example output
{
  "card_id": "1909958737779491858",
  "id": "1909958739624985637",
  "name": "Checklist",
  "tasks": []
}

Attach file to card

Attach a file, such as an email's attachment or a generated report, to a card.

Inputs

CardcardtextRequired
The card: its ID from another PLANKA step or a trigger, or its link in PLANKA.
FilefiletextRequired
The file: upload one, pick one from an earlier step, or give a public https link to download.
Namenametext
What to call the attachment. Leave blank for the file's own name.

Outputs

card_idtext
The ID of the card it's on
created_attext
When it was added
idtext
The attachment's ID, which other PLANKA steps take
nametext
Its name
sizenumber
A file's size in bytes, 0 for a link
typetext
file or link
urltext
The link, or where the file downloads for someone signed in
Example output
{
  "card_id": "1909958737779491858",
  "created_at": "2026-11-03T10:00:00.000Z",
  "id": "1909959969722074162",
  "name": "brief.pdf",
  "size": 48213,
  "type": "file",
  "url": "https://planka.example.com/attachments/1909959969722074162/download/brief.pdf"
}

Attach a link, such as the document or ticket a card is about, to a card.

Inputs

CardcardtextRequired
The card: its ID from another PLANKA step or a trigger, or its link in PLANKA.
LinkurltextRequired
The link, such as https://example.com/brief.
Namenametext
What to call the link. Leave blank for the site's address.

Outputs

card_idtext
The ID of the card it's on
created_attext
When it was added
idtext
The attachment's ID, which other PLANKA steps take
nametext
Its name
sizenumber
A file's size in bytes, 0 for a link
typetext
file or link
urltext
The link, or where the file downloads for someone signed in
Example output
{
  "card_id": "1909958737779491858",
  "created_at": "2026-11-03T10:00:00.000Z",
  "id": "1909959969722074162",
  "name": "Brief",
  "size": 0,
  "type": "link",
  "url": "https://example.com/brief"
}

Create board

Add a board to a project, after its other boards. The person the connection acts as becomes its first member.

Inputs

ProjectprojecttextRequired
The project: pick one, or give its ID from another PLANKA step, its link or its name.
NamenametextRequired
What to call the board.

Outputs

cardslist
The board's cards, list by list (not the archive or trash)
cards_totalnumber
How many cards that is
created_attext
When it was created
idtext
The board's ID, which other PLANKA steps take
labelslist
The board's labels
linktext
Where the board opens in PLANKA
listslist
The board's lists, left to right
memberslist
The people on the board
nametext
The board's name
positionnumber
Where it sits among the project's boards
project_idtext
The ID of the project it belongs to
project_nametext
That project's name
Example output
{
  "cards": [],
  "cards_total": 0,
  "created_at": "2026-11-02T09:16:00.000Z",
  "id": "1909958735917220871",
  "labels": [],
  "link": "https://planka.example.com/boards/1909958735917220871",
  "lists": [],
  "members": [
    {
      "board_role": "editor",
      "deactivated": false,
      "email": "riley@example.com",
      "id": "1909958735514567684",
      "name": "Riley Chen",
      "role": "boardUser",
      "username": "riley"
    }
  ],
  "name": "Launch plan",
  "position": 65536,
  "project_id": "1909958735665562629",
  "project_name": "Website relaunch"
}

Create card

Add a card to a list, such as one for each new form response or email, with a description and a due date.

Inputs

BoardboardtextRequired
The board: pick one, or give its ID from another PLANKA step, its link or its name, such as Launch plan.
ListlisttextRequired
The list on that board: pick one, or give its ID or its name, such as Doing.
TitlenametextRequired
The card's title.
Descriptiondescriptiontext
The card's description. PLANKA shows Markdown formatted.
Due datedue_datedate and time
When the card is due. Leave blank for no due date.
Positionpositiontext
Whether it goes last or first. Defaults to last.One of: bottom (Last), top (First). Default: bottom.

Outputs

board_idtext
The ID of the board it's on
board_nametext
That board's name
closedtrue/false
Whether it's in a closed list, so counts as done
comments_totalnumber
How many comments it has
created_attext
When it was created
descriptiontext
Its description
due_completedtrue/false
Whether its due date is ticked as done
due_datetext
When it's due, blank when it has no due date
idtext
The card's ID, which other PLANKA steps take
label_idslist
The IDs of its labels
labelslist
The names of its labels
linktext
Where the card opens in PLANKA
list_idtext
The ID of the list it's in
list_nametext
That list's name, such as Doing
member_idslist
The IDs of the people on it
memberslist
The names of the people on it
nametext
The card's title
positionnumber
Where it sits in its list
tasks_completednumber
How many of them are ticked off
tasks_totalnumber
How many tasks it has
updated_attext
When it was last changed
Example output
{
  "board_id": "1909958735917220871",
  "board_name": "Launch plan",
  "closed": false,
  "comments_total": 2,
  "created_at": "2026-11-02T09:20:00.000Z",
  "description": "Headline, three sections and a call to action.",
  "due_completed": false,
  "due_date": "2026-11-19T17:00:00.000Z",
  "id": "1909958737779491858",
  "label_ids": [],
  "labels": [],
  "link": "https://planka.example.com/cards/1909958737779491858",
  "list_id": "1909958736303096844",
  "list_name": "To do",
  "member_ids": [],
  "members": [],
  "name": "Write homepage copy",
  "position": 65536,
  "tasks_completed": 1,
  "tasks_total": 3,
  "updated_at": "2026-11-03T14:05:00.000Z"
}

Create label

Add a label, such as Urgent, to a board.

Inputs

BoardboardtextRequired
The board: pick one, or give its ID from another PLANKA step, its link or its name, such as Launch plan.
NamenametextRequired
What the label says.
Colorcolortext
The label's colour. Defaults to lagoon blue.One of: berry-red (Berry red), pumpkin-orange (Pumpkin orange), light-orange (Light orange), egg-yellow (Egg yellow), sunny-grass (Sunny grass), fresh-salad (Fresh salad), bright-moss (Bright moss), tank-green (Tank green), lagoon-blue (Lagoon blue), morning-sky (Morning sky), and 32 more. Default: lagoon-blue.

Outputs

board_idtext
The ID of the board it belongs to
colortext
Its colour, as PLANKA names it, such as berry-red
idtext
The label's ID, which other PLANKA steps take
nametext
What the label says
Example output
{
  "board_id": "1909958735917220871",
  "color": "berry-red",
  "id": "1909958736697361423",
  "name": "Urgent"
}

Create list

Add a list, such as To do or Done, to a board.

Inputs

BoardboardtextRequired
The board: pick one, or give its ID from another PLANKA step, its link or its name, such as Launch plan.
NamenametextRequired
What to call the list.
Typelist_typetext
Active for work in progress, or closed for a list whose cards count as done. Defaults to active.One of: active, closed. Default: active.
Positionpositiontext
Whether it goes last or first. Defaults to last.One of: bottom (Last), top (First). Default: bottom.

Outputs

board_idtext
The ID of the board it's on
cards_totalnumber
How many cards are in it
idtext
The list's ID, which other PLANKA steps take
nametext
The list's name
positionnumber
Where it sits on the board
typetext
active, or closed for a list whose cards count as done
Example output
{
  "board_id": "1909958735917220871",
  "cards_total": 0,
  "id": "1909958736303096844",
  "name": "To do",
  "position": 65536,
  "type": "active"
}

Create project

Start a project, such as one for each new client. The person the connection acts as becomes its manager.

Inputs

NamenametextRequired
What to call the project.
Descriptiondescriptiontext
What the project is for.
Visibilityvisibilitytext
Private is seen by its managers and the members of its boards; shared is also seen by every administrator. Defaults to private.One of: private, shared. Default: private.

Outputs

boardslist
The project's boards
boards_totalnumber
How many of its boards the connection can see
created_attext
When it was created
descriptiontext
Its description
hiddentrue/false
Whether the project is hidden from the home page
idtext
The project's ID, which other PLANKA steps take
linktext
Where the project opens in PLANKA
nametext
The project's name
Example output
{
  "boards": [],
  "boards_total": 0,
  "created_at": "2026-11-02T09:15:00.000Z",
  "description": "Everything for the spring launch",
  "hidden": false,
  "id": "1909958735665562629",
  "link": "https://planka.example.com/projects/1909958735665562629",
  "name": "Website relaunch"
}

Delete attachment

Delete a file or link from its card.

Inputs

AttachmentattachmenttextRequired
The attachment's ID, from 'List attachments', 'Get card' or an attach step.

Outputs

deletedtrue/false
True once it's deleted
idtext
The ID of what was deleted
nametext
Its name, blank for a comment
Example output
{
  "deleted": true,
  "id": "1909959969722074162",
  "name": "brief.pdf"
}

Delete board

Delete a board for good, with its lists, cards, comments and attachments.

Inputs

BoardboardtextRequired
The board: pick one, or give its ID from another PLANKA step, its link or its name, such as Launch plan.

Outputs

deletedtrue/false
True once it's deleted
idtext
The ID of what was deleted
nametext
Its name, blank for a comment
Example output
{
  "deleted": true,
  "id": "1909958735917220871",
  "name": "Launch plan"
}

Delete card

Delete a card for good, with its comments, tasks and attachments.

Inputs

CardcardtextRequired
The card: its ID from another PLANKA step or a trigger, or its link in PLANKA.

Outputs

deletedtrue/false
True once it's deleted
idtext
The ID of what was deleted
nametext
Its name, blank for a comment
Example output
{
  "deleted": true,
  "id": "1909958737779491858",
  "name": "Write homepage copy"
}

Delete comment

Delete a comment. The person the connection acts as must have written it, or manage the project.

Inputs

CommentcommenttextRequired
The comment's ID, from 'Add comment', 'List comments' or a trigger.

Outputs

deletedtrue/false
True once it's deleted
idtext
The ID of what was deleted
nametext
Its name, blank for a comment
Example output
{
  "deleted": true,
  "id": "1909958739314607138",
  "name": ""
}

Delete list

Delete a list from a board. PLANKA moves its cards to the board's trash.

Inputs

BoardboardtextRequired
The board: pick one, or give its ID from another PLANKA step, its link or its name, such as Launch plan.
ListlisttextRequired
The list on that board: pick one, or give its ID or its name, such as Doing.

Outputs

cards_moved_to_trashnumber
How many cards PLANKA moved to the board's trash
deletedtrue/false
True once the list is deleted
idtext
The deleted list's ID
nametext
Its name
Example output
{
  "cards_moved_to_trash": 2,
  "deleted": true,
  "id": "1909958736303096844",
  "name": "To do"
}

Delete project

Delete a project. PLANKA deletes only a project with no boards, so delete its boards first.

Inputs

ProjectprojecttextRequired
The project: pick one, or give its ID from another PLANKA step, its link or its name.

Outputs

deletedtrue/false
True once it's deleted
idtext
The ID of what was deleted
nametext
Its name, blank for a comment
Example output
{
  "deleted": true,
  "id": "1909958735665562629",
  "name": "Website relaunch"
}

Delete task

Delete a task from its task list.

Inputs

TasktasktextRequired
The task: its ID from another PLANKA step, or its name if you also give the card it's on.
Cardcardtext
The card the task is on (its ID or link). Only needed when the task is given by name.

Outputs

deletedtrue/false
True once it's deleted
idtext
The ID of what was deleted
nametext
Its name, blank for a comment
Example output
{
  "deleted": true,
  "id": "1909958740077970472",
  "name": "Review"
}

Delete task list

Delete a task list from a card, with its tasks.

Inputs

Task listtask_listtextRequired
The task list: its ID from another PLANKA step, or its name if you also give the card it's on.
Cardcardtext
The card the task list is on (its ID or link). Only needed when the task list is given by name.

Outputs

deletedtrue/false
True once it's deleted
idtext
The ID of what was deleted
nametext
Its name, blank for a comment
Example output
{
  "deleted": true,
  "id": "1909958739624985637",
  "name": "Checklist"
}

Duplicate card

Copy a card, such as a template card, with its description, labels, members, task lists and attachments, to the end of its list.

Inputs

CardcardtextRequired
The card: its ID from another PLANKA step or a trigger, or its link in PLANKA.
Titlenametext
The copy's title. Leave blank for the original's.

Outputs

board_idtext
The ID of the board it's on
board_nametext
That board's name
closedtrue/false
Whether it's in a closed list, so counts as done
comments_totalnumber
How many comments it has
copied_from_idtext
The ID of the card it was copied from
created_attext
When it was created
descriptiontext
Its description
due_completedtrue/false
Whether its due date is ticked as done
due_datetext
When it's due, blank when it has no due date
idtext
The card's ID, which other PLANKA steps take
label_idslist
The IDs of its labels
labelslist
The names of its labels
linktext
Where the card opens in PLANKA
list_idtext
The ID of the list it's in
list_nametext
That list's name, such as Doing
member_idslist
The IDs of the people on it
memberslist
The names of the people on it
nametext
The card's title
positionnumber
Where it sits in its list
tasks_completednumber
How many of them are ticked off
tasks_totalnumber
How many tasks it has
updated_attext
When it was last changed
Example output
{
  "board_id": "1909958735917220871",
  "board_name": "Launch plan",
  "closed": false,
  "comments_total": 2,
  "copied_from_id": "1909958737779491858",
  "created_at": "2026-11-02T09:20:00.000Z",
  "description": "Headline, three sections and a call to action.",
  "due_completed": false,
  "due_date": "2026-11-19T17:00:00.000Z",
  "id": "1909959967624922157",
  "label_ids": [
    "1909958736697361423"
  ],
  "labels": [
    "Urgent"
  ],
  "link": "https://planka.example.com/cards/1909959967624922157",
  "list_id": "1909958736303096844",
  "list_name": "To do",
  "member_ids": [
    "1909958735514567684"
  ],
  "members": [
    "Riley Chen"
  ],
  "name": "Write homepage copy (copy)",
  "position": 65536,
  "tasks_completed": 1,
  "tasks_total": 3,
  "updated_at": "2026-11-03T14:05:00.000Z"
}

Get board

Get a board with its lists, labels, members and cards, such as for a weekly summary of what's in each list.

Inputs

BoardboardtextRequired
The board: pick one, or give its ID from another PLANKA step, its link or its name, such as Launch plan.

Outputs

cardslist
The board's cards, list by list (not the archive or trash)
cards_totalnumber
How many cards that is
created_attext
When it was created
idtext
The board's ID, which other PLANKA steps take
labelslist
The board's labels
linktext
Where the board opens in PLANKA
listslist
The board's lists, left to right
memberslist
The people on the board
nametext
The board's name
positionnumber
Where it sits among the project's boards
project_idtext
The ID of the project it belongs to
project_nametext
That project's name
Example output
{
  "cards": [
    {
      "board_id": "1909958735917220871",
      "board_name": "Launch plan",
      "closed": false,
      "comments_total": 2,
      "created_at": "2026-11-02T09:20:00.000Z",
      "description": "Headline, three sections and a call to action.",
      "due_completed": false,
      "due_date": "2026-11-19T17:00:00.000Z",
      "id": "1909958737779491858",
      "label_ids": [
        "1909958736697361423"
      ],
      "labels": [
        "Urgent"
      ],
      "link": "https://planka.example.com/cards/1909958737779491858",
      "list_id": "1909958736303096844",
      "list_name": "To do",
      "member_ids": [
        "1909958735514567684"
      ],
      "members": [
        "Riley Chen"
      ],
      "name": "Write homepage copy",
      "position": 65536,
      "tasks_completed": 1,
      "tasks_total": 3,
      "updated_at": "2026-11-03T14:05:00.000Z"
    }
  ],
  "cards_total": 1,
  "created_at": "2026-11-02T09:16:00.000Z",
  "id": "1909958735917220871",
  "labels": [
    {
      "board_id": "1909958735917220871",
      "color": "berry-red",
      "id": "1909958736697361423",
      "name": "Urgent"
    }
  ],
  "link": "https://planka.example.com/boards/1909958735917220871",
  "lists": [
    {
      "board_id": "1909958735917220871",
      "cards_total": 2,
      "id": "1909958736303096844",
      "name": "To do",
      "position": 65536,
      "type": "active"
    }
  ],
  "members": [
    {
      "board_role": "editor",
      "deactivated": false,
      "email": "riley@example.com",
      "id": "1909958735514567684",
      "name": "Riley Chen",
      "role": "boardUser",
      "username": "riley"
    }
  ],
  "name": "Launch plan",
  "position": 65536,
  "project_id": "1909958735665562629",
  "project_name": "Website relaunch"
}

Get card

Get a card with its list, labels, members, due date, task lists and attachments.

Inputs

CardcardtextRequired
The card: its ID from another PLANKA step or a trigger, or its link in PLANKA.

Outputs

attachmentslist
Its files and links
board_idtext
The ID of the board it's on
board_nametext
That board's name
closedtrue/false
Whether it's in a closed list, so counts as done
comments_totalnumber
How many comments it has
created_attext
When it was created
descriptiontext
Its description
due_completedtrue/false
Whether its due date is ticked as done
due_datetext
When it's due, blank when it has no due date
idtext
The card's ID, which other PLANKA steps take
label_idslist
The IDs of its labels
labelslist
The names of its labels
linktext
Where the card opens in PLANKA
list_idtext
The ID of the list it's in
list_nametext
That list's name, such as Doing
member_idslist
The IDs of the people on it
memberslist
The names of the people on it
nametext
The card's title
positionnumber
Where it sits in its list
task_listslist
Its task lists, each with its tasks
tasks_completednumber
How many of them are ticked off
tasks_totalnumber
How many tasks it has
updated_attext
When it was last changed
Example output
{
  "attachments": [
    {
      "card_id": "1909958737779491858",
      "created_at": "2026-11-03T10:00:00.000Z",
      "id": "1909959969722074162",
      "name": "brief.pdf",
      "size": 48213,
      "type": "file",
      "url": "https://planka.example.com/attachments/1909959969722074162/download/brief.pdf"
    }
  ],
  "board_id": "1909958735917220871",
  "board_name": "Launch plan",
  "closed": false,
  "comments_total": 2,
  "created_at": "2026-11-02T09:20:00.000Z",
  "description": "Headline, three sections and a call to action.",
  "due_completed": false,
  "due_date": "2026-11-19T17:00:00.000Z",
  "id": "1909958737779491858",
  "label_ids": [
    "1909958736697361423"
  ],
  "labels": [
    "Urgent"
  ],
  "link": "https://planka.example.com/cards/1909958737779491858",
  "list_id": "1909958736303096844",
  "list_name": "To do",
  "member_ids": [
    "1909958735514567684"
  ],
  "members": [
    "Riley Chen"
  ],
  "name": "Write homepage copy",
  "position": 65536,
  "task_lists": [
    {
      "id": "1909958739624985637",
      "name": "Checklist",
      "tasks": [
        {
          "assignee_id": "",
          "completed": true,
          "id": "1909958740077970472",
          "name": "Review",
          "task_list_id": "1909958739624985637"
        }
      ]
    }
  ],
  "tasks_completed": 1,
  "tasks_total": 3,
  "updated_at": "2026-11-03T14:05:00.000Z"
}

Get project

Get a project with its boards.

Inputs

ProjectprojecttextRequired
The project: pick one, or give its ID from another PLANKA step, its link or its name.

Outputs

boardslist
The project's boards
boards_totalnumber
How many of its boards the connection can see
created_attext
When it was created
descriptiontext
Its description
hiddentrue/false
Whether the project is hidden from the home page
idtext
The project's ID, which other PLANKA steps take
linktext
Where the project opens in PLANKA
nametext
The project's name
Example output
{
  "boards": [
    {
      "created_at": "2026-11-02T09:16:00.000Z",
      "id": "1909958735917220871",
      "link": "https://planka.example.com/boards/1909958735917220871",
      "name": "Launch plan",
      "position": 65536,
      "project_id": "1909958735665562629",
      "project_name": "Website relaunch"
    }
  ],
  "boards_total": 1,
  "created_at": "2026-11-02T09:15:00.000Z",
  "description": "Everything for the spring launch",
  "hidden": false,
  "id": "1909958735665562629",
  "link": "https://planka.example.com/projects/1909958735665562629",
  "name": "Website relaunch"
}

List attachments

List the files and links attached to a card.

Inputs

CardcardtextRequired
The card: its ID from another PLANKA step or a trigger, or its link in PLANKA.

Outputs

attachmentslist
The card's files and links
countnumber
How many there are
Example output
{
  "attachments": [
    {
      "card_id": "1909958737779491858",
      "created_at": "2026-11-03T10:00:00.000Z",
      "id": "1909959969722074162",
      "name": "brief.pdf",
      "size": 48213,
      "type": "file",
      "url": "https://planka.example.com/attachments/1909959969722074162/download/brief.pdf"
    }
  ],
  "count": 1
}

List boards

List the boards the connection can see, in one project or in all of them.

Inputs

Projectprojecttext
Only this project's boards. Leave blank for every project.

Outputs

boardslist
The boards
countnumber
How many there are
Example output
{
  "boards": [
    {
      "created_at": "2026-11-02T09:16:00.000Z",
      "id": "1909958735917220871",
      "link": "https://planka.example.com/boards/1909958735917220871",
      "name": "Launch plan",
      "position": 65536,
      "project_id": "1909958735665562629",
      "project_name": "Website relaunch"
    }
  ],
  "count": 1
}

List cards

List a board's cards in the board's order: all of them, or those in one list, with one label, given to one person, or with certain words.

Inputs

BoardboardtextRequired
The board: pick one, or give its ID from another PLANKA step, its link or its name, such as Launch plan.
Listlisttext
Only cards in this list, such as Doing.
Labellabeltext
Only cards with this label.
Membermembertext
Only cards this person is on.
Searchsearchtext
Only cards whose title or description has all of these words.
Limitlimitnumber
The most cards to return, from 1 to 1000. Leave blank for 100.From 1 to 1000.

Outputs

cardslist
The cards, in the board's order
countnumber
How many cards are returned
has_moretrue/false
Whether more matched than the limit returned
totalnumber
How many cards matched
Example output
{
  "cards": [
    {
      "board_id": "1909958735917220871",
      "board_name": "Launch plan",
      "closed": false,
      "comments_total": 2,
      "created_at": "2026-11-02T09:20:00.000Z",
      "description": "Headline, three sections and a call to action.",
      "due_completed": false,
      "due_date": "2026-11-19T17:00:00.000Z",
      "id": "1909958737779491858",
      "label_ids": [
        "1909958736697361423"
      ],
      "labels": [
        "Urgent"
      ],
      "link": "https://planka.example.com/cards/1909958737779491858",
      "list_id": "1909958736303096844",
      "list_name": "To do",
      "member_ids": [
        "1909958735514567684"
      ],
      "members": [
        "Riley Chen"
      ],
      "name": "Write homepage copy",
      "position": 65536,
      "tasks_completed": 1,
      "tasks_total": 3,
      "updated_at": "2026-11-03T14:05:00.000Z"
    }
  ],
  "count": 1,
  "has_more": false,
  "total": 1
}

List comments

List a card's comments, newest first.

Inputs

CardcardtextRequired
The card: its ID from another PLANKA step or a trigger, or its link in PLANKA.
Limitlimitnumber
The most comments to return, from 1 to 1000. Leave blank for 100.From 1 to 1000.

Outputs

commentslist
The comments, newest first
countnumber
How many are returned
has_moretrue/false
Whether the card has more than the limit returned
Example output
{
  "comments": [
    {
      "card_id": "1909958737779491858",
      "created_at": "2026-11-03T14:05:00.000Z",
      "id": "1909958739314607138",
      "text": "Needs a shorter headline.",
      "user_id": "1909958735514567684",
      "user_name": "Riley Chen"
    }
  ],
  "count": 1,
  "has_more": false
}

List labels

List a board's labels.

Inputs

BoardboardtextRequired
The board: pick one, or give its ID from another PLANKA step, its link or its name, such as Launch plan.

Outputs

countnumber
How many there are
labelslist
The board's labels
Example output
{
  "count": 1,
  "labels": [
    {
      "board_id": "1909958735917220871",
      "color": "berry-red",
      "id": "1909958736697361423",
      "name": "Urgent"
    }
  ]
}

List people

List the people in PLANKA, to find who to add to a card. A connection that isn't an administrator or project owner gets the people in its own projects.

Inputs

None.

Outputs

countnumber
How many there are
userslist
The people
Example output
{
  "count": 1,
  "users": [
    {
      "deactivated": false,
      "email": "riley@example.com",
      "id": "1909958735514567684",
      "name": "Riley Chen",
      "role": "boardUser",
      "username": "riley"
    }
  ]
}

List projects

List the projects the connection can see, with how many boards each has.

Inputs

None.

Outputs

countnumber
How many there are
projectslist
The projects
Example output
{
  "count": 1,
  "projects": [
    {
      "boards_total": 1,
      "created_at": "2026-11-02T09:15:00.000Z",
      "description": "Everything for the spring launch",
      "hidden": false,
      "id": "1909958735665562629",
      "link": "https://planka.example.com/projects/1909958735665562629",
      "name": "Website relaunch"
    }
  ]
}

Move card

Move a card to another list, such as Done, on its own board or another.

Inputs

CardcardtextRequired
The card: its ID from another PLANKA step or a trigger, or its link in PLANKA.
BoardboardtextRequired
The board to move it to (the card's own board, or another): pick one, or give its ID from another PLANKA step, its link or its name.
ListlisttextRequired
The list to move it to: pick one, or give its ID or its name, such as Done.
Positionpositiontext
Whether it goes last or first. Defaults to last.One of: bottom (Last), top (First). Default: bottom.

Outputs

board_idtext
The ID of the board it's on
board_nametext
That board's name
closedtrue/false
Whether it's in a closed list, so counts as done
comments_totalnumber
How many comments it has
created_attext
When it was created
descriptiontext
Its description
due_completedtrue/false
Whether its due date is ticked as done
due_datetext
When it's due, blank when it has no due date
idtext
The card's ID, which other PLANKA steps take
label_idslist
The IDs of its labels
labelslist
The names of its labels
linktext
Where the card opens in PLANKA
list_idtext
The ID of the list it's in
list_nametext
That list's name, such as Doing
member_idslist
The IDs of the people on it
memberslist
The names of the people on it
moved_from_list_idtext
The ID of the list the card was in before
nametext
The card's title
positionnumber
Where it sits in its list
tasks_completednumber
How many of them are ticked off
tasks_totalnumber
How many tasks it has
updated_attext
When it was last changed
Example output
{
  "board_id": "1909958735917220871",
  "board_name": "Launch plan",
  "closed": false,
  "comments_total": 2,
  "created_at": "2026-11-02T09:20:00.000Z",
  "description": "Headline, three sections and a call to action.",
  "due_completed": false,
  "due_date": "2026-11-19T17:00:00.000Z",
  "id": "1909958737779491858",
  "label_ids": [
    "1909958736697361423"
  ],
  "labels": [
    "Urgent"
  ],
  "link": "https://planka.example.com/cards/1909958737779491858",
  "list_id": "1909958736428925965",
  "list_name": "Doing",
  "member_ids": [
    "1909958735514567684"
  ],
  "members": [
    "Riley Chen"
  ],
  "moved_from_list_id": "1909958736303096844",
  "name": "Write homepage copy",
  "position": 65536,
  "tasks_completed": 1,
  "tasks_total": 3,
  "updated_at": "2026-11-03T14:05:00.000Z"
}

Remove label from card

Take a label off a card.

Inputs

CardcardtextRequired
The card: its ID from another PLANKA step or a trigger, or its link in PLANKA.
LabellabeltextRequired
One of the labels of the card's board: pick one, or give its ID or its name, such as Urgent.

Outputs

board_idtext
The ID of the board it's on
board_nametext
That board's name
closedtrue/false
Whether it's in a closed list, so counts as done
comments_totalnumber
How many comments it has
created_attext
When it was created
descriptiontext
Its description
due_completedtrue/false
Whether its due date is ticked as done
due_datetext
When it's due, blank when it has no due date
idtext
The card's ID, which other PLANKA steps take
label_idtext
The label's ID
label_idslist
The IDs of its labels
labelslist
The names of its labels
linktext
Where the card opens in PLANKA
list_idtext
The ID of the list it's in
list_nametext
That list's name, such as Doing
member_idslist
The IDs of the people on it
memberslist
The names of the people on it
nametext
The card's title
positionnumber
Where it sits in its list
removedtrue/false
Whether the label was taken off: false when the card didn't have it
tasks_completednumber
How many of them are ticked off
tasks_totalnumber
How many tasks it has
updated_attext
When it was last changed
Example output
{
  "board_id": "1909958735917220871",
  "board_name": "Launch plan",
  "closed": false,
  "comments_total": 2,
  "created_at": "2026-11-02T09:20:00.000Z",
  "description": "Headline, three sections and a call to action.",
  "due_completed": false,
  "due_date": "2026-11-19T17:00:00.000Z",
  "id": "1909958737779491858",
  "label_id": "1909958736697361423",
  "label_ids": [],
  "labels": [],
  "link": "https://planka.example.com/cards/1909958737779491858",
  "list_id": "1909958736303096844",
  "list_name": "To do",
  "member_ids": [
    "1909958735514567684"
  ],
  "members": [
    "Riley Chen"
  ],
  "name": "Write homepage copy",
  "position": 65536,
  "removed": true,
  "tasks_completed": 1,
  "tasks_total": 3,
  "updated_at": "2026-11-03T14:05:00.000Z"
}

Remove member from card

Take a person off a card.

Inputs

CardcardtextRequired
The card: its ID from another PLANKA step or a trigger, or its link in PLANKA.
PersonusertextRequired
A member of the card's board: pick one, or give their ID, username, email or name.

Outputs

board_idtext
The ID of the board it's on
board_nametext
That board's name
closedtrue/false
Whether it's in a closed list, so counts as done
comments_totalnumber
How many comments it has
created_attext
When it was created
descriptiontext
Its description
due_completedtrue/false
Whether its due date is ticked as done
due_datetext
When it's due, blank when it has no due date
idtext
The card's ID, which other PLANKA steps take
label_idslist
The IDs of its labels
labelslist
The names of its labels
linktext
Where the card opens in PLANKA
list_idtext
The ID of the list it's in
list_nametext
That list's name, such as Doing
member_idslist
The IDs of the people on it
memberslist
The names of the people on it
nametext
The card's title
positionnumber
Where it sits in its list
removedtrue/false
Whether they were taken off: false when they weren't on the card
tasks_completednumber
How many of them are ticked off
tasks_totalnumber
How many tasks it has
updated_attext
When it was last changed
user_idtext
The person's ID
Example output
{
  "board_id": "1909958735917220871",
  "board_name": "Launch plan",
  "closed": false,
  "comments_total": 2,
  "created_at": "2026-11-02T09:20:00.000Z",
  "description": "Headline, three sections and a call to action.",
  "due_completed": false,
  "due_date": "2026-11-19T17:00:00.000Z",
  "id": "1909958737779491858",
  "label_ids": [
    "1909958736697361423"
  ],
  "labels": [
    "Urgent"
  ],
  "link": "https://planka.example.com/cards/1909958737779491858",
  "list_id": "1909958736303096844",
  "list_name": "To do",
  "member_ids": [],
  "members": [],
  "name": "Write homepage copy",
  "position": 65536,
  "removed": true,
  "tasks_completed": 1,
  "tasks_total": 3,
  "updated_at": "2026-11-03T14:05:00.000Z",
  "user_id": "1909958735514567684"
}

Update card

Change a card's title, description or due date, or tick its due date as done. Fields left blank stay as they are.

Inputs

CardcardtextRequired
The card: its ID from another PLANKA step or a trigger, or its link in PLANKA.
Titlenametext
A new title.
Descriptiondescriptiontext
A new description.
Due datedue_datedate and time
A new due date.
Remove due dateremove_due_datetrue/false
Turn on to take the due date off the card.Default: false.
Due date donedue_completedtext
Whether the due date is ticked as done.One of: keep (Leave as it is), yes, no. Default: keep.

Outputs

board_idtext
The ID of the board it's on
board_nametext
That board's name
closedtrue/false
Whether it's in a closed list, so counts as done
comments_totalnumber
How many comments it has
created_attext
When it was created
descriptiontext
Its description
due_completedtrue/false
Whether its due date is ticked as done
due_datetext
When it's due, blank when it has no due date
idtext
The card's ID, which other PLANKA steps take
label_idslist
The IDs of its labels
labelslist
The names of its labels
linktext
Where the card opens in PLANKA
list_idtext
The ID of the list it's in
list_nametext
That list's name, such as Doing
member_idslist
The IDs of the people on it
memberslist
The names of the people on it
nametext
The card's title
positionnumber
Where it sits in its list
tasks_completednumber
How many of them are ticked off
tasks_totalnumber
How many tasks it has
updated_attext
When it was last changed
Example output
{
  "board_id": "1909958735917220871",
  "board_name": "Launch plan",
  "closed": false,
  "comments_total": 2,
  "created_at": "2026-11-02T09:20:00.000Z",
  "description": "Headline, three sections and a call to action.",
  "due_completed": false,
  "due_date": "2026-11-19T17:00:00.000Z",
  "id": "1909958737779491858",
  "label_ids": [
    "1909958736697361423"
  ],
  "labels": [
    "Urgent"
  ],
  "link": "https://planka.example.com/cards/1909958737779491858",
  "list_id": "1909958736303096844",
  "list_name": "To do",
  "member_ids": [
    "1909958735514567684"
  ],
  "members": [
    "Riley Chen"
  ],
  "name": "Write homepage copy",
  "position": 65536,
  "tasks_completed": 1,
  "tasks_total": 3,
  "updated_at": "2026-11-03T14:05:00.000Z"
}

Update list

Rename a list, move it first or last on its board, or change whether its cards count as done.

Inputs

BoardboardtextRequired
The board: pick one, or give its ID from another PLANKA step, its link or its name, such as Launch plan.
ListlisttextRequired
The list on that board: pick one, or give its ID or its name, such as Doing.
Namenametext
A new name. Leave blank to keep it.
Positionpositiontext
Move the list first or last on the board.One of: keep (Leave where it is), top (First), bottom (Last). Default: keep.
Typelist_typetext
Active, or closed for a list whose cards count as done.One of: keep (Leave as it is), active, closed. Default: keep.

Outputs

board_idtext
The ID of the board it's on
cards_totalnumber
How many cards are in it
idtext
The list's ID, which other PLANKA steps take
nametext
The list's name
positionnumber
Where it sits on the board
typetext
active, or closed for a list whose cards count as done
Example output
{
  "board_id": "1909958735917220871",
  "cards_total": 2,
  "id": "1909958736303096844",
  "name": "To do",
  "position": 65536,
  "type": "active"
}

Update task

Tick a task off or untick it, rename it, or give it to someone.

Inputs

TasktasktextRequired
The task: its ID from another PLANKA step, or its name if you also give the card it's on.
Cardcardtext
The card the task is on (its ID or link). Only needed when the task is given by name.
Completedcompletedtext
Whether the task is ticked off.One of: keep (Leave as it is), yes, no. Default: keep.
Namenametext
A new name for the task.
Assigneeassigneetext
Who the task is given to: a member of the board.

Outputs

assignee_idtext
The ID of the person it's given to, blank for nobody
completedtrue/false
Whether it's ticked off
idtext
The task's ID, which other PLANKA steps take
nametext
What the task says
task_list_idtext
The ID of the task list it's in
Example output
{
  "assignee_id": "",
  "completed": true,
  "id": "1909958740077970472",
  "name": "Review",
  "task_list_id": "1909958739624985637"
}

On this page