Create Customer

Overview

This endpoint creates a new customer.
To do this, you have to build your complete endpoint by passing the API version and the authorization token in the query parameters, then pass all the required payload in the request body.

Required Payload

Create customer required payload and their descriptions.

Name	Data Type	Description	Mandatory/Optional
LastName	String	Customers last name	Mandatory
OtherNames	String	Customer's other names	Mandatory
City	String	Customer's city	Optional
Address	String	Customer's Address	Mandatory
Gender	String	Customer's Gender	Mandatory
DateOfBirth	Date	Customer's date of birth	Mandatory
PhoneNo	String	Customet's phone Number	Mandatory
PlaceofBirth	String	Customer's place of birth	Mandatory
NationalIdentityNo	String	Customer's NIN	Mandatory
NextOfKinName	String	Customer's next of kin's name	Optional
NextOfKinPhoneNumber	String	Customer's next of kin's phone number	Optional
ReferralName	String	Name of person that referred the customer	Optional
ReferralPhone	String	Phone number of person that referred the customer	Optional
BankVerificationNumber	String	Customer's BVN	Mandatory
Email	String	Customer's email	Optional
HasCompleteDocumentation	Boolean	Checks that the customer has completed the document	Mandatory
AccountOfficerCode	String	Customer's account officer code	Mandatory

Expected Request

{
  "LastName": "Test",
  "OtherNames": "Customer",
  "City": "Lagos",
  "Address": "Yaba, Lagos",
  "Gender": 0,
  "DateOfBirth": "2023-07-31",
  "PhoneNo": "09090908989",
  "PlaceOfBirth": "Lagos",
  "NationalIdentityNo": "56789823543",
  "NextOfKinName": "string",
  "NextOfKinPhoneNumber": "string",
  "ReferralName": "string",
  "ReferralPhoneNo": "string",
  "BankVerificationNumber": "19087235678",
  "Email": "[email protected]",
  "HasCompleteDocumentation": true,
  "AccountOfficerCode": "001",
  "customerPassportInBytes": ""
 
}

Expected Response

If the request is successful, it returns a status code of 200 with a response body.


{
  "LastName": "Test",
  "OtherNames": "Customer",
  "Address": "Yaba, Lagos",
  "Gender": "Male",
  "DateOfBirth": "2023-07-31T00:00:00",
  "PhoneNo": "09090908989",
  "NationalIdentityNo": "56789823543",
  "CustomerType": "Individual",
  "BankVerificationNumber": "19087235678",
  "CustomerID": "004529",
  "Email": "[email protected]"
}

You can checkout API reference for Creating a new customer