DKBSignDocs

API reference

POSTRequires Bearer token

Preview CSV import

/api/contacts/imports/csv/preview

Multipart. Detects encoding, delimiter, headers, sample rows, and a suggested mapping (first_name, last_name, email, phone, title, company → CSV column names).

Path parameters

This endpoint has no path parameters.

Query parameters

This endpoint has no query parameters.

Request body

Send as multipart/form-data.

FieldTypeDescription
file
Required
stringCSV file.
e.g. "example"

Responses

StatusMeaning
200CSV preview
401Missing or invalid Bearer token.

Request

curl
curl -X POST 'https://api.dkbsigns.com/api/contacts/imports/csv/preview' \
  -H 'Authorization: Bearer $DKBSIGN_TOKEN' \
  -H 'Accept: application/json' \
  -F 'file=example'

Response 200

json
{
  "encoding": "utf-8",
  "delimiter": ";",
  "headers": [
    "nom",
    "courriel"
  ],
  "sample_rows": [
    {
      "nom": "Kouassi",
      "courriel": "ada@acme.test"
    }
  ],
  "suggested_mapping": {
    "last_name": "nom",
    "email": "courriel"
  }
}