/v1/definitions/{key}/import/autoImport a spreadsheet, mapping it for you
Imports a file onto a pack page WITHOUT being told which column is which — send the sheet as it came: headers (its first row) and rows (every other row, as arrays of text in header order). Reach for this whenever somebody hands you a spreadsheet, a CSV or a pasted table for an existing page; reach for post_definitions_key_import instead only when you already know the mapping and have rows keyed by column. The service folds each header onto the page's own columns, reads what every column actually holds, asks Neo only about the headers whose names did not settle them (5 seconds at most; past that the plan stands on the names and values and plan.modelProblem says so), and creates the columns the page is missing. The identity — which headers say which row is which, so a re-import updates instead of duplicating — is the page's own: its last import's, else its email, phone, EIN or legal-name column; Neo names one only when the page has none among the file's headers. The answer carries the plan it used — one entry per header saying what it decided, why, and how sure it was — beside the ordinary import result, so you can tell the person what went where. dryRun: true is for a caller who wants to check a mapping before anything is written: the same plan and per-row outcomes come back. A file attached in Neo chat is imported, never dry-run — 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. Same ceiling as every import — 5000 rows, refused whole with too_many_rows — and the same undo: post_definitions_key_imports_runId_undo rolls the whole run back using the runId in the result. In Neo chat, a spreadsheet attached to the message — a pasted Google Sheets, OneDrive or CSV link arrives as one — goes as attachment with the file's name INSTEAD of headers and rows; the rows are supplied at the door, never retyped.
Access class: def:read.
Send request
Use the documented inputs to call this endpoint directly.
Parameters
Values are applied to the request and the example on the right.
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"
}
],
"columnsCreated": [
{
"id": "",
"kind": "string",
"label": "string"
}
],
"counts": {
"created": 1,
"failed": 1,
"skipped": 1,
"updated": 1
},
"definition": {
"access": "string",
"columns": [
"string"
],
"createdAt": "2026-01-01T00:00:00Z",
"icon": "string",
"id": "",
"key": "string",
"name": "string",
"object": "string",
"pack": "string",
"position": 1,
"purpose": "string",
"recordsEnabled": true,
"statuses": [
"string"
],
"tagsEnabled": true,
"templateKey": "string",
"updatedAt": "2026-01-01T00:00:00Z",
"view": "string",
"views": [
"string"
]
},
"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"
}