DKBSignDocs

API reference

POSTRequires Bearer token

Create a company user

/api/users/create

company_id in the body is overwritten with the caller’s company. A password-reset email is sent unless the company is LDAP-managed.

Path parameters

This endpoint has no path parameters.

Query parameters

This endpoint has no query parameters.

Request body

FieldTypeDescription
name
Required
stringLast name.
e.g. "Kouassi"
firstname
Required
stringFirst name.
e.g. "Ada"
email
Required
stringUnique email.
e.g. "ada@acme.test"
cni_number
Required
stringID document number.
e.g. "CI123456"
phone
Required
stringUnique phone.
e.g. "+2250700000001"
company_id
Required
integerIgnored — replaced with the caller’s company.
e.g. 1
role_id
Required
integerRole in the caller’s company.
e.g. 3

Responses

StatusMeaning
201User created
401Missing or invalid Bearer token.

Request

curl
curl -X POST 'https://api.dkbsigns.com/api/users/create' \
  -H 'Authorization: Bearer $DKBSIGN_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{"name":"Kouassi","firstname":"Ada","email":"ada@acme.test","cni_number":"CI123456","phone":"+2250700000001","company_id":1,"role_id":3}'

Response 201

json
{
  "success": true,
  "user": {
    "id": 4,
    "first_name": "Jane",
    "last_name": "Doe",
    "email": "user@acme.test",
    "role": "user",
    "company_id": 1,
    "job_title": "Chief Financial Officer",
    "locale": "fr",
    "seal": null,
    "signature_mentions": {
      "enabled": true,
      "frame": false,
      "mentions": [
        "fullName",
        "jobTitle"
      ]
    },
    "is_available": true
  }
}