Action: Create a Board

Trello Operation

The Trello action enables users to create a single Trello Board

Example User Story

I want to create a Trello Board so that I can start adding project Cards to it.

Fields

Field Name	Field Type	Required	Description
name	String	Yes	Name of the board
defaultLists	Boolean	No	Whether to create default lists (To Do, Doing, Done)
defaultLabels	Boolean	No	Whether to create default labels
desc	String	No	Description for the board

Related Connections

Related Automations

Example link

Code (Apache v2.0): Operation

{
  "handle": "post-boards",
  "state": "inDev",
  "meta": {
    "short": "Post Boards",
    "description": "Create a new board in Trello"
  },
  "input": [
    {
      "name": "name",
      "type": "String",
      "required": true,
      "meta": {
        "description": "Name of the board"
      }
    },
    {
      "name": "defaultLists",
      "type": "Boolean",
      "required": false,
      "meta": {
        "description": "Whether to create default lists (To Do, Doing, Done)"
      }
    },
    {
      "name": "defaultLabels",
      "type": "Boolean",
      "required": false,
      "meta": {
        "description": "Whether to create default labels"
      }
    },
    {
      "name": "desc",
      "type": "String",
      "required": false,
      "meta": {
        "description": "Description for the board"
      }
    }
  ],
  "output": [
    {
      "name": "id",
      "type": "String",
      "selector": ["id"],
      "meta": {
        "description": "ID of the created board"
      }
    },
    {
      "name": "name",
      "type": "String",
      "selector": ["name"],
      "meta": {
        "description": "Name of the created board"
      }
    },
    {
      "name": "url",
      "type": "String",
      "selector": ["url"],
      "meta": {
        "description": "URL of the created board"
      }
    }
  ],
  "steps": [
    {
      "type": "http",
      "http": {
        "method": "POST",
        "path": "/1/boards/",
        "headers": {
          "Content-Type": "application/json"
        },
        "bodyTemplate": {
          "value": "{\"name\":\"{{name}}\",\"defaultLists\":{{defaultLists}},\"defaultLabels\":{{defaultLabels}},\"desc\":\"{{desc}}\"}",
          "placeholders": [
            {
              "name": "name",
              "type": "String",
              "description": "Name of the board",
              "required": true
            },
            {
              "name": "defaultLists",
              "type": "Boolean",
              "description": "Whether to create default lists",
              "required": false
            },
            {
              "name": "defaultLabels",
              "type": "Boolean",
              "description": "Whether to create default labels",
              "required": false
            },
            {
              "name": "desc",
              "type": "String",
              "description": "Description for the board",
              "required": false
            }
          ]
        }
      }
    }
  ]
}