Create Organization Customer

Creates a new organization customer without an account

Overview

This endpoint creates a new organization 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 organization customer required payload and their descriptions.

Name	Data Type	Description	Mandatory/Optional
Name	String	Account name	Mandatory
PhoneNo	String	Business phone number	Mandatory
PostalAddress	String	Business postal address	Mandatory
BusinessPhoneNo	String	Business phone number	Optional
TaxIDNo	String	Tax ID number	Optional
BusinessName	Date	Business name	Mandatory
TradeName	String	Trade name	Mandatory
IndustrialSector	String	Business sector	Optional
Email	String	Business mail	Mandatory
Address	String	Business Address	Mandatory
CompanyRegDate	String	Business registration date	Mandatory
ContactPersonName	String	Name of contact person	Optional
BusinessType	String	Business type	Optional
BusinessNature	String	Business nature	Optional
WebAddress	String	Business website	Optional
DateIncorporated	String	Business incorporation date	Optional
BusinessCommencementDate	String	Business commencement date	Mandatory
RegistrationNumber	String	Business registration number	Mandatory
CustomerMembers	Array	Customer ID created for Directors	Mandatory
TheDirectors	Array	Customer ID created for Directors	Mandatory

📘

NOTE

In the request body, the fields "CustomerMembers" and "TheDirectors" are passed as an array_string as seen below

"CustomerMembers": [
"022982",
"022980",
"022973"
],
"TheDirectors": [
"022982",
"022980",
"022973"
]

Expected Request

JSON

{
  "Name": "Qore Enterprise",
  "PhoneNo": "0908889873",
  "PostalAddress": "somolu",
  "BusinessPhoneNo": "09039888987",
  "TaxIDNo": "T44565",
  "BusinessName": "Qore Enterprise",
  "TradeName": "Qore Enterprise",
  "IndustrialSector": "Finance",
  "Email": "[email protected]",
  "Address": "Lagos",
  "CompanyRegDate": "2001-09-19T20:22:52.340Z",
  "ContactPersonName": "",
  "BusinessType": "Finance",
  "BusinessNature": "Finance",
  "WebAddress": "www.qoreenterrpise.com",
  "DateIncorporated": "2001-09-19T20:22:52.340Z",
  "BusinessCommencementDate": "2004-09-19T20:22:52.340Z",
  "RegistrationNumber": "A334523",
   "CustomerMembers": [
    "022982",
    "022980",
    "022973"
  ],
  "TheDirectors": [
    "022982",
    "022980",
    "022973"
  ] 
}

Expected Response

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

JSON

{
    "IsSuccessful": true,
    "CustomerIDInString": "023001",
    "Message": "Organization customer created successfully",
    "TransactionTrackingRef": null,
    "Page": null
}

You can checkout API reference for Create Organization Customer