DKBSignDocs

API reference

POSTRequires Bearer token

Create contact

/api/contacts

Owner-scoped create. 409 duplicate_contact when the owner already has that email.

Path parameters

This endpoint has no path parameters.

Query parameters

This endpoint has no query parameters.

Request body

FieldTypeDescription
first_name
stringFirst name.
e.g. "Ada"
last_name
stringLast name.
e.g. "Kouassi"
email
stringEmail (normalized). Duplicate email for the same owner → 409.
e.g. "ada@acme.test"
phone
stringPhone, normalized with the default region from config.
e.g. "+2250700000001"
title
stringJob title.
e.g. "CFO"
company
stringOrganisation name.
e.g. "ACME"
visibility
stringprivate or org. Default comes from contacts settings.
e.g. "private"
extra
objectOptional extra keys (for example cni_number, role_id).

Responses

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

Request

curl
curl -X POST 'https://api.dkbsigns.com/api/contacts' \
  -H 'Authorization: Bearer $DKBSIGN_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{"first_name":"Ada","last_name":"Kouassi","email":"ada@acme.test","phone":"+2250700000001","title":"CFO","company":"ACME","visibility":"private","extra":{}}'

Response 201

json
{
  "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "first_name": "Ada",
  "last_name": "Kouassi",
  "email": "ada@acme.test",
  "visibility": "private",
  "source": "manual"
}