Create a board

Create a named, coloured board in the credential tenancy.

Last reviewed October 19, 2026Download Markdown ↓

POSThttps://api.peekpanda.com/v1/boards

Request

A duplicate name returns 409. At most 100 boards per personal space or workspace.

Parameters

NameInTypeRequiredDescription

namebodystringYesBoard name, unique within the tenancy.

colorbody#rrggbbYesOptional colour; defaults to bamboo green.

Response

The new board.

Response fields

idstring

namestring

colorstring

scopestring

workspaceIdnull

ownerUserIdstring

appCountnumber

adCountnumber

createdAtstring

updatedAtstring

Authentication

Requires Bearer API credential or OAuth access token. Scope content:write. MCP calls manage_boards with action create.

Errors

400invalid_request for an invalid filter, identity or limit.

401authentication_required for a missing or invalid credential.

402subscription_required when access is not entitled.

403authorization_required for a missing scope or unavailable preview access.

403workspace_not_accessible when x-genviral-tenancy names a workspace the credential cannot reach.

404not_found when the record is outside the accessible catalogue.

429rate_limited; honor Retry-After when present.

429daily_call_limit; the plan's daily API and MCP calls are used until 00:00 UTC.

409conflict when the write would duplicate an exclusive row.

MCP request

Call manage_boards with action create. Path fields go in params, filters in query, and a write body in body.

{
  "name": "manage_boards",
  "arguments": {
    "request": {
      "action": "create"
    }
  }
}

Source

Boards are the caller's own organization, stored in PeekPanda. Apps carry the listing name and icon as added; evidence counts are stored paid-ad observations.

Refresh

Board reads never call a provider or start collection. An app on any board in a space is tracked there, and tracking collects its paid ads, organic posts, keywords and chart position.

AI agent or LLM? Read this page as markdown