POST
/
api
/
v1
/
customers
/
individual-customers
/
create
Create a new retail customer.
curl --request POST \
  --url https://demoapi.saasphereltd.com/api/v1/customers/individual-customers/create \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "title": "Mr.",
  "first_name": "John",
  "last_name": "Doe",
  "middle_name": "Michael",
  "email": "john.doe@example.com",
  "bvn": "12345678901",
  "phone_number": "08012345678",
  "phone_number_country_code": "+234",
  "phone_number_2": "08098765432",
  "phone_number_2_country_code": "+234",
  "marital_status": "single",
  "gender": "male",
  "dob": "<any>",
  "id_type": "national_id",
  "id_card_no": "A12345678",
  "house_address": "123 Main Street",
  "city": "Lagos",
  "state": "Lagos",
  "education_level": "bachelor",
  "employment_status": "employed",
  "business_name": "ABC Trading",
  "business_address": "456 Business Ave",
  "employer_id": 10,
  "sector_id": 5,
  "net_monthly_income": 150000,
  "is_business_registered": true,
  "business_registration_number": "RC123456",
  "nok_name": "Jane Doe",
  "nok_relationship": "spouse",
  "nok_address": "789 Kin Street",
  "account_number": "1234567890",
  "account_name": "John Doe",
  "bank_code": "044",
  "nok_bvn": "98765432109",
  "form_field": [
    "architecto"
  ]
}
'
{
  "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"

​
marital_status
string
required

The customer's marital status.

Example:

"single"

​
gender
string
required

The customer's gender.

Example:

"male"

​
dob
any
​
id_type
string
required

The ID card type.

Example:

"national_id"

​
id_card_no
string
required

The ID card number.

Example:

"A12345678"

​
house_address
string
required

The customer's house address.

Example:

"123 Main Street"

​
city
string
required

The customer's city.

Example:

"Lagos"

​
state
string
required

The customer's state.

Example:

"Lagos"

​
nok_name
string
required

The next of kin's name.

Example:

"Jane Doe"

​
nok_relationship
string
required

The relationship to next of kin.

Example:

"spouse"

​
nok_address
string
required

The next of kin's address.

Example:

"789 Kin Street"

​
account_number
string
required

The customer's bank account number.

Example:

"1234567890"

​
account_name
string
required

The customer's bank account name.

Example:

"John Doe"

​
bank_code
string
required

The bank code.

Example:

"044"

​
title
string

optional The customer's title.

Example:

"Mr."

​
middle_name
string

optional The customer's middle name.

Example:

"Michael"

​
phone_number_country_code
string

optional The phone number country code.

Example:

"+234"

​
phone_number_2
string

optional Secondary 11-digit phone number.

Example:

"08098765432"

​
phone_number_2_country_code
string

optional Secondary phone number country code.

Example:

"+234"

​
education_level
string

optional The customer's education level.

Example:

"bachelor"

​
employment_status
string

optional The customer's employment status.

Example:

"employed"

​
business_name
string

optional The customer's business name.

Example:

"ABC Trading"

​
business_address
string

optional The business address.

Example:

"456 Business Ave"

​
employer_id
integer

optional The employer ID (must exist).

Example:

10

​
sector_id
integer

optional The sector ID (must exist).

Example:

5

​
net_monthly_income
number

optional The net monthly income.

Example:

150000

​
is_business_registered
boolean

optional Whether the business is registered.

Example:

true

​
business_registration_number
string

optional The business registration number (required if is_business_registered is true).

Example:

"RC123456"

​
nok_bvn
string

optional The next of kin's 11-digit BVN.

Example:

"98765432109"

​
form_field
string[]

optional Array of custom form fields.

Example:
["architecto"]

Response

201 - application/json
​
status
string
Example:

"00"

​
message
string
Example:

"Customer created successfully with Customer ID: CUST001"

​
data
object