/v1/boardsMake a board
Creates a custom board — a table somebody makes for themselves, as opposed to a pack page like leads or deals — in ONE call, choices included. Body: name, an optional purpose, and columns as {label, kind, config}, kind being one of text, number, date, select, checkbox, url, email, phone, person, tags, currency, percent, rating, relation, datetime, long_text, address, file, formula, lookup. A select column takes its choices HERE: config.options as [{label, value?, tone?}] (tone: secondary, brandLight, brand, warning, success, destructive) — never one options call per choice afterwards. A relation (record link) column needs config.definitionKey, the page or board it links to — a page key such as leads, or a board's own board-… key — and is refused without it. Always send recordTabs too: which tabs the board's record pop-up shows besides Overview — send activity, notes, files and tasks on every board, plus calls when the rows carry a phone or email column — fewer only when the person asks for fewer. An unknown tab is a 400 naming it; left out, the app shows its default set. To make a board FROM data instead, reach for post_boards_import and omit its boardId. MANY ITEMS PER ROW (an order's 25 line items, a client's orders, a deal's documents) is NOT a select or a long text: a select holds ONE fixed choice. Make a second board for the items with a relation column pointing back at this one (each item one row, its quantity and status in their own columns), or a child page with subrecords.
Access class: workspace.
Send request
Use the documented inputs to call this endpoint directly.
Request body
application/jsonrequiredResponses
the action's answer
{
"data": {
"access": "string",
"canShare": true,
"columns": [
{
"calculation": "string",
"config": {},
"id": "",
"kind": "string",
"label": "string",
"options": [
"string"
],
"position": 1.5,
"starred": true
}
],
"createdAt": "2026-01-01T00:00:00Z",
"definitionKey": "string",
"id": "",
"name": "string",
"purpose": "string",
"recordTabs": [
"string"
],
"rowCount": 1,
"rows": [
"string"
],
"updatedAt": "2026-01-01T00:00:00Z",
"view": "string"
}
}a refusal: {"error": "<what a person needs to read>"}. 401 no credential, 402 the plan does not include this, 403 the seat does not, 404 the thing does not exist or is not yours to see.
{
"error": "string"
}