Skip to main content
POST
/
customers
/
add
Create Customer
curl --request POST \
  --url https://waas-staging.embedly.ng/api/v1/customers/add \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "organizationId": "<string>",
  "firstName": "<string>",
  "lastName": "<string>",
  "middleName": "<string>",
  "emailAddress": "<string>",
  "mobileNumber": "<string>",
  "dob": "<string>",
  "customerTypeId": "<string>",
  "address": "<string>",
  "city": "<string>",
  "countryId": "<string>",
  "alias": "<string>"
}
'
{
  "code": "00",
  "success": true,
  "message": "Created Successfully",
  "data": {
    "id": "788859f5-d3b2-11f0-97df-02789e000022",
    "organizationId": "0075b72d-6648-11f0-a7cf-0274f77d4a81",
    "firstName": "string",
    "lastName": "string",
    "middleName": "string",
    "dob": "2025-12-05T10:57:13",
    "customerTypeId": "f671da57-e281-4b40-965f-a96f4205405e",
    "customerTierId": 0,
    "alias": null,
    "countryId": "c15ad9ae-c4d7-4342-b70f-de5508627e3b",
    "city": "string",
    "address": "string",
    "mobileNumber": "08039494859",
    "emailAddress": "[email protected]",
    "dateCreated": null,
    "isCorporateVerified": ""
  }
}

​
Create Customer

Use this endpoint to create profile for an individual.
Once a customer profile is created, you are required to provide the customer’s BVN and NIN via the KYC endpoints. Please note: A customer must attain a KYC Tier 1 status before an open wallet can be created for them.

​
Request Parameters

​
organizationId
string
required
​
firstName
string
required
The first name of the individual. Example: John
​
lastName
string
required
The last name of the individual. Example: Doe
​
middleName
string
required
The middle name of the individual. Example: Michael
​
emailAddress
string
required
The individual’s email address. Example: [email protected]
​
mobileNumber
string
required
The individual’s phone number. Example: 08012345678
​
dob
string
required
The individual’s date of birth in YYYY-MM-DD format. Example: 1980-01-01
​
customerTypeId
string
required
The type of customer. (Must be a UUID) Example: f671da57-e281-4b40-965f-a96f4205405e The value should be gotten from the get customer types endpoint in the customer utils section
​
address
string
required
The customer’s residential street. Example: 20 Marina
​
city
string
required
The customer’s residential city. Example: Lagos
​
countryId
string
required
The unique identifier of the customer’s nationality. (Must be a UUID) Example: f671da57-e281-4b40-965f-a96f4205405e The value should be gotten from the get countries endpoint in the customer utils section
​
alias
string
{
  "code": "00",
  "success": true,
  "message": "Created Successfully",
  "data": {
    "id": "788859f5-d3b2-11f0-97df-02789e000022",
    "organizationId": "0075b72d-6648-11f0-a7cf-0274f77d4a81",
    "firstName": "string",
    "lastName": "string",
    "middleName": "string",
    "dob": "2025-12-05T10:57:13",
    "customerTypeId": "f671da57-e281-4b40-965f-a96f4205405e",
    "customerTierId": 0,
    "alias": null,
    "countryId": "c15ad9ae-c4d7-4342-b70f-de5508627e3b",
    "city": "string",
    "address": "string",
    "mobileNumber": "08039494859",
    "emailAddress": "[email protected]",
    "dateCreated": null,
    "isCorporateVerified": ""
  }
}