Create a new customer on our platform

post

https://api.playbox.grow.curacel.co/api/v1/customers

Create a new customer

Creates a new customer which can be subsequently used to place an order for a product. Insurance regulation requires that KYC be done, thus a lot of fields would be mandato

Optional KYC parameters

The following parameters may be omitted

bvn
proof_of_address

When the above parameters are absent, the customer will get an email notification with instructions to provide them.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Body Params

Details of customers to be created

ref

string

Your unique identifier for the customer as it exists on your database. This would be used to identify this customer in all other operations.

first_name

string

required

last_name

string

required

middle_name

string

sex

string

enum

Must be either M or F

Allowed:

birth_date

date

required

Customer's date of birth e.g 1990-10-10

string

required

Customer's email address. This need not be unique if the ref is provided.

phone

string

required

Customer's phone number.

bvn

string

occupation

string

id_card

file

required

ID card of the customer

id_type

string

enum

required

type of ID

Allowed:

id_expiry

string

required

expiry date of the ID

id_number

string

required

Number of the ID

city

string

required

residential_address

string

required

This is required to be able to purchase credit life products

state

string

required

nationality

string

country

string

required

next_of_kin_name

string

This is required to be able to purchase credit life products The name of customer's next of kin

next_of_kin_phone

string

This is required to be able to purchase credit life products Phone number of next of kin

proof_of_address

object

The proof of the customer's address as part of required KYC. The type can be any string describing what type of document it is. The url should be a publicly accessible file at the time of making this request as it would be copied and stored for insurers to view.

Responses

201Created

422Unprocessable Content