Create Boards in an Organization

Use this guide to add new boards inside an existing Playbook organization.

Prerequisites

1. Access Token (access_token): A valid OAuth2 token for a user with permissions to manage boards.
2. Organization Slug (slug): The URL-friendly identifier for your organization (e.g., coolclient-ltd).

Endpoint & Authentication

POST /api/v1/{slug}/boards
Authorization: Bearer <access_token>
Content-Type: application/json

Request Payload

Field	Type	Required	Description
title	string	yes	Name of the new board.
description	string	no	Optional description for it.
parent_id	string	no	Token of a parent folder, to nest boards.

Sample Request

curl -X POST https://be.playbook.com/api/v1/coolclient-ltd/boards \
  -H "Authorization: Bearer ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Marketing Assets",
    "description": "Images and banners for marketing"
}'

Sample Response

HTTP/1.1 200 OK
Content-Type: application/json

{
  "data": {
    "id": 123,
    "token": "marketing-assets",
    "title": "Marketing Assets",
    "description": "Images and banners for marketing",
    "created_at": "2023-07-10T12:34:56Z",
    "updated_at": "2023-07-10T12:34:56Z",
    "parent_id": null
  }
}

Error Handling

• 401 Unauthorized: Missing or invalid access_token.
• 422 Unprocessable Entity: Validation errors (e.g., missing title).
• 404 Not Found: The specified slug does not exist.

Next Steps

• Use the new token from the response when uploading assets into this board.