Skip to main content
POST
Error

Authorizations

Authorization
string
header
required

Flowyte secret API key (Authorization: Bearer flowyte_sk_live_…). Scope-gated; is scoped to your organization — a key can never reach another tenant. The listed scopes in each operation's apiKey requirement are the scopes that key must hold. The tokenUrl is nominal: keys are minted in the dashboard.

Path Parameters

id
string
required

The contact-list id to import into.

Body

multipart/form-data
file
file
required

The CSV file (first row = header). Max 16 MB.

columnMapping
string
required

A JSON object (sent as a form-field string) mapping canonical fields to source column headers, e.g. {"phone":"Phone","name":"First Name","appointment_time":"Visit"}.

Response

Import counts + the list's new state.

success
boolean
required
data
object
required
message
string
errors
object[]