/v1/boards/import/autoImport a spreadsheet onto a board, mapping it for you
The custom-board twin of post_definitions_key_import_auto: send a file as headers plus rows and the service works out the mapping itself. In Neo chat, when the person attached a spreadsheet, send attachment with the file's name INSTEAD of headers and rows — the rows are supplied at the door, never retyped. A Google Sheets, OneDrive or CSV link pasted into the chat arrives as an attached file and goes the same way. Pass boardId to import onto a board that exists, or name with no boardId to MAKE a board from the file — which is the call to reach for when somebody wants a spreadsheet turned into a board, because the columns and their kinds are read off the file's own values. The answer carries the plan it used — what each header became, why, and how sure it was — beside the ordinary import result. dryRun: true is for a caller who wants to check a mapping before anything is written — the plan still comes back; a file attached in Neo chat is imported, never dry-run, because the file in the chat is the instruction. A new dropdown arrives with every choice the file uses, ordered, coloured and grouped, and the answer's columnsCreated and optionsAdded say what was made. At most 5000 rows, refused whole with too_many_rows, and post_boards_id_imports_runId_undo takes the run back. When it MAKES the board, send recordTabs too — which tabs the record pop-up shows besides Overview, activity, notes, files and tasks on every board, plus calls for a phone or email column (fewer only when the person asks); with a boardId it is a 400, since patch_boards_id changes an existing board's tabs.
Access class: workspace.
Send request
Use the documented inputs to call this endpoint directly.
Request body
application/jsonrequiredValues: "all" · "first" · "last"
Values: "add" · "blank" · "reject"
Responses
the action's answer
{
"data": {
"import": {
"blankedCells": [
{
"count": "string",
"reason": "string",
"rows": "string"
}
],
"board": {
"access": "string",
"canShare": true,
"columns": [
"string"
],
"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"
},
"columnsCreated": [
{
"id": "",
"kind": "string",
"label": "string"
}
],
"counts": {
"created": 1,
"failed": 1,
"skipped": 1,
"updated": 1
},
"notLanded": [
{
"count": "string",
"outcome": "string",
"reason": "string",
"rows": "string"
}
],
"optionsAdded": [
{
"columnId": "",
"groups": "string",
"label": "string",
"values": "string"
}
],
"results": [
{
"blanked": "string",
"error": "string",
"id": "",
"outcome": "string",
"row": "string"
}
],
"runId": ""
},
"plan": {
"columns": [
{
"choices": "string",
"decidedBy": "string",
"decision": "string",
"profile": "string",
"proposed": "string"
}
],
"conflicts": [
{
"columnId": "",
"header": "string",
"kind": "string",
"label": "string",
"match": "string",
"reason": "string",
"wanted": "string"
}
],
"identity": [
"string"
],
"modelProblem": "string",
"notes": "string",
"setup": {
"nameHeader": "string",
"pipelineHeader": "string",
"view": "string"
},
"source": "string",
"statusFolds": [
{
"applied": "string",
"from": "string",
"header": "string",
"into": "string",
"notApplied": "string",
"reason": "string"
}
],
"surface": "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"
}