DKBSignDocs

API reference

POSTRequires Bearer token

Create LDAP connection

/api/contacts/ldap-connections

Submit `/api/contacts/ldap-connections`. Authenticated routes need `Authorization: Bearer {token}` from `POST /api/v1/login`.

Path parameters

This endpoint has no path parameters.

Query parameters

This endpoint has no query parameters.

Request body

FieldTypeDescription
name
Required
stringConnection label.
e.g. "Corporate AD"
host
Required
stringLDAP host.
e.g. "ldap.acme.test"
port
integerLDAP port.
e.g. 389
bind_dn
Required
stringBind DN.
bind_password
Required
stringBind password.
base_dn
Required
stringSearch base DN.

Responses

StatusMeaning
500See the example response.

Request

curl
curl -X POST 'https://api.dkbsigns.com/api/contacts/ldap-connections' \
  -H 'Authorization: Bearer $DKBSIGN_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{"name":"Corporate AD","host":"ldap.acme.test","port":389}'

Response 200

json
{
  "status": "success",
  "message": "Upstream response is forwarded unchanged."
}