Trello API: Create Board

The Create Board endpoint allows you to create a new board in Trello. You need to provide a board name, and optionally, additional parameters such as default lists and organization ID.

Endpoint Details

Method: POST
Endpoint URL: https://api.trello.com/1/boards
Authentication: Requires key and token as query parameters.

Required Parameters

Parameter	Type	Description
`name`	String	The name of the new board.

Optional Parameters

Parameter	Type	Description
`defaultLists`	Boolean	Determines whether default lists (To Do, Doing, Done) should be created.
`idOrganization`	String	The ID of the organization to which the board belongs.

Example API Request


POST https://api.trello.com/1/boards
Content-Type: application/json

{
  "name": "New Board Example",
  "defaultLists": true,
  "idOrganization": "60d21b4967d0d810b8f8b456",
  "key": "YOUR_API_KEY",
  "token": "YOUR_ACCESS_TOKEN"
}

Example API Response


{
  "id": "60d21b4967d0d810b8f8b456",
  "name": "New Board Example",
  "url": "https://trello.com/b/12345abcd/NewBoardExample",
  "prefs": {
    "permissionLevel": "private",
    "voting": "disabled",
    "comments": "members",
    "invitations": "members",
    "selfJoin": true,
    "cardCovers": true,
    "background": "blue",
    "calendarFeedEnabled": false
  }
}

Common Errors & Solutions

Error Code	Possible Cause	Solution
400 Bad Request	Missing required parameters	Ensure the `name` parameter is included.
401 Unauthorized	Invalid API key or token	Check API credentials and re-authenticate.
404 Not Found	Invalid `idOrganization` value	Ensure the provided `idOrganization` exists and is accessible.