boards.create

Create a board

Request: POST/api/v1/boards
Scope required: boards:write
Effect: Changes data. Send an Idempotency-Key if you might retry it.
Acts on: Acts on the account’s own job search.
MCP tool: boards_create
Environment: Live and sandbox alike.
Request body: JSON.

What it does

Creates a board and makes it the active one, which deactivates whichever board was active before — an account has exactly one active board at a time. The new board starts empty and with the default display settings. Send an `Idempotency-Key` header if a retry must not create a second board. The board it answers with is the one `applications.create` files cards onto.

Request body

name: string, required

Response

applicationCount: integer, required
createdAt: string, required
id: string, required
isActive: boolean, required
name: string, required
updatedAt: string, required

Examples

Start a new search

Start a new search — request

curl -s -X POST https://www.jobapplicationtracking.com/api/v1/boards \
  -H "Authorization: Bearer $JAT_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "name": "Spring search"
}'

Start a new search — response

{
  "id": "brd_7",
  "name": "Spring search",
  "isActive": true,
  "applicationCount": 0,
  "createdAt": "2026-01-04T09:30:00.000Z",
  "updatedAt": "2026-02-11T17:05:00.000Z"
}