DKBSignDocs

API reference

POSTRequires Bearer token

Import clients

/api/clients/import

Company-admin. 1–1000 rows, same keys as create. Dedup key is email (existing emails are skipped, not errors). Throttled (10/min).

Path parameters

This endpoint has no path parameters.

Query parameters

This endpoint has no query parameters.

Request body

FieldTypeDescription
clients
Required
array1–1000 client objects (name, firstname, cni_number, phone, email, motif_demande).
e.g. [{"name":"Dupont","firstname":"Marie","cni_number":"CI123456","phone":"+2250700000000","email":"marie@example.com","motif_demande":"Account opening"}]

Responses

StatusMeaning
200Imported
401Missing or invalid Bearer token.

Request

curl
curl -X POST 'https://api.dkbsigns.com/api/clients/import' \
  -H 'Authorization: Bearer $DKBSIGN_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{"clients":[{"name":"Dupont","firstname":"Marie","cni_number":"CI123456","phone":"+2250700000000","email":"marie@example.com","motif_demande":"Account opening"}]}'

Response 200

json
{
  "message": "Import terminé",
  "created": 12,
  "skipped": 3,
  "errors": []
}