DKBSignDocs

API reference

POSTRequires Bearer token

Create a client

/api/clients/create

Counterparty attached to workflows. Email is unique per company. Any company member may create.

Path parameters

This endpoint has no path parameters.

Query parameters

This endpoint has no query parameters.

Request body

FieldTypeDescription
name
Required
stringLast name (max 191).
e.g. "Dupont"
firstname
Required
stringFirst name (max 191).
e.g. "Marie"
cni_number
Required
stringID document number (max 191).
e.g. "CI123456"
phone
Required
stringPhone (max 30).
e.g. "+2250700000000"
email
Required
stringEmail, unique per company (normalized lowercase).
e.g. "marie@example.com"
motif_demande
Required
stringRequest reason (max 191).
e.g. "Account opening"

Responses

StatusMeaning
201See the example response.
401Missing or invalid Bearer token.

Request

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

Response 201

json
{
  "message": "Enregistrement effectué",
  "client": {
    "id": 12,
    "email": "marie@example.com"
  }
}