POST
/
api
/
v1
/
customers
/
individual-customers
/
tier1
/
create
Create a new tier 1 retail customer (simplified KYC).
curl --request POST \
  --url https://demoapi.saasphereltd.com/api/v1/customers/individual-customers/tier1/create \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "first_name": "John",
  "last_name": "Doe",
  "email": "john.doe@example.com",
  "bvn": "12345678901",
  "phone_number": "08012345678",
  "gender": "male",
  "dob": "1990-05-15",
  "middle_name": "Michael",
  "nin": "12345678901"
}
'
{
  "status": "00",
  "message": "Customer created successfully with Customer ID: CUST001",
  "data": {}
}

Authorizations

​
Authorization
string
header
required

Paste only the token (no "Bearer " prefix).

Body

application/json
​
first_name
string
required

The customer's first name.

Example:

"John"

​
last_name
string
required

The customer's last name.

Example:

"Doe"

​
email
string
required

The customer's email (must be unique).

Example:

"john.doe@example.com"

​
bvn
string
required

The customer's 11-digit BVN (must be unique).

Example:

"12345678901"

​
phone_number
string
required

The customer's 11-digit phone number (must be unique).

Example:

"08012345678"

​
gender
string
required

The customer's gender.

Example:

"male"

​
dob
date
required

The customer's date of birth.

Example:

"1990-05-15"

​
middle_name
string

optional The customer's middle name.

Example:

"Michael"

​
nin
string

optional The customer's 11-digit NIN (must be unique).

Example:

"12345678901"

Response

201 - application/json
​
status
string
Example:

"00"

​
message
string
Example:

"Customer created successfully with Customer ID: CUST001"

​
data
object