Preview a lead CSV import

This page documents the canonical HTTP contract for this endpoint.

The response example is abridged; mappings and detected_types depend on the uploaded file and mapping analysis. standard_fields is the static standard-field catalog, not inferred from the uploaded file. Use the import endpoint only after reviewing the preview and mappings.

Body parameters

filerequired
file<text/csv>
CSV file uploaded as multipart form data.
sample_size · optional
integer
Maximum sample rows shown; runtime clamps this to at least 1 and no more than the row count.
null_policy · optional
string
common treats configured common null tokens as empty; preserve retains input values.

Name	Type	Description
filerequired	file<text/csv>	CSV file uploaded as multipart form data.
sample_size	integer	Maximum sample rows shown; runtime clamps this to at least 1 and no more than the row count.
null_policy	string	common treats configured common null tokens as empty; preserve retains input values.

Errors

Status	Meaning
401	Authentication is missing or invalid.
403	The credential is invalid or lacks the required scope.
400	The CSV cannot be parsed.
500	Preview mapping failed.

Example

bash

curl -X POST "https://app.autotouch.ai/api/leads/import/preview" \
  -H "Authorization: Bearer $AUTOTOUCH_API_KEY" \
  -F "file=@./leads.csv" \
  -F "sample_size=5" \
  -F "null_policy=common"

Response example

json

{
  "headers": [
    "First Name",
    "Email",
    "Company Domain"
  ],
  "sample_rows": [
    {
      "First Name": "Alex",
      "Email": "alex@example.test",
      "Company Domain": "example.test"
    }
  ],
  "mappings": [
    {
      "csv_column": "Email",
      "standard_field": "email"
    }
  ],
  "unmapped_columns": [],
  "detected_types": {
    "Email": "email"
  },
  "standard_fields": [
    {
      "key": "email",
      "label": "Email",
      "aliases": [
        "email_address"
      ],
      "allow_multiple": false,
      "badge": "standard",
      "field_semantics": {},
      "fieldSemantics": {}
    }
  ],
  "coverage": {
    "company_domain": {
      "total_rows": 1,
      "with_value": 1,
      "mapped_columns": [
        "Company Domain"
      ]
    },
    "linkedin_url": {
      "total_rows": 1,
      "with_value": 0,
      "mapped_columns": []
    }
  }
}