Skip to main content
POST
Re-preview an upload with a mapping

Authorizations

Authorization
string
header
required

Project API key (sk_api_…).

Path Parameters

uploadId
string<uuid>
required

The uploadId returned by /contact-lists/uploads.

Body

application/json
mapping
object

Omit it to re-run auto-detection — the same preview the upload returned.

Response

The parse under the requested mapping.

summary
object
detectedMapping
object

The mapping applied. Overrides you sent are resolved to header names — an A1 letter comes back as its header — and the rest is auto-detected.

sample
object[]

First 10 contacts that would be called, after normalization.

total
integer

Data rows read, excluding the header. summary.willBeCalled and the summary.excluded counts add up to this.

columns
string[]

Headers as parsed, in file order — the choices for a mapping override.

mappingIssues
enum<string>[]

Columns that resolved to nothing. Check this first when everything is excluded — an unmapped phone column makes every number look invalid.

Available options:
phoneColumnNotFound,
nameColumnNotFound