Skip to main content
POST
Add a person

Authorizations

X-Ladder-Key
string
header
required

Your key id: pk_test_… (sandbox) or pk_live_… (live).

X-Ladder-Timestamp
string
header
required

Unix seconds, as a string; must be within 5 minutes of server time.

X-Ladder-Signature
string
header
required

Lower-case hex HMAC-SHA512 over timestamp, method, path+query and the SHA-256 of the body. See Authentication.

Headers

Idempotency-Key
string
required

Unique per logical request (max 255 chars). A retry with the same key and body returns the original response with Idempotent-Replayed: true; a different body returns 409.

Body

application/json
roles
enum<string>[]
required
Available options:
director,
beneficial_owner,
signatory,
admin
first_name
string
required
Required string length: 1 - 100
last_name
string
required
Required string length: 1 - 100
date_of_birth
string<date>
required
nationality
string
required
Required string length: 1 - 3
id_type
enum<string>
required
Available options:
passport,
nin,
ghana_card,
drivers_license,
voters_card
id_number
string
required
Required string length: 1 - 64
middle_name
string
Maximum string length: 100
email
string<email>
Maximum string length: 254
phone
string
Maximum string length: 50
residential_address
string
ownership_percentage
string<decimal>
bvn
string
Pattern: ^\d{11}$
is_pep
boolean
pep_details
string

Response

data
object
required