POST
/
customers
/
add
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>"
}'
{
    "statuscode": "00",
    "message": "Customer successfully profiled",
    "data": {
      "customerId": "7100987614",
    }
    "errors": [],
}

​
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: john.doe@example.com

​
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
{
    "statuscode": "00",
    "message": "Customer successfully profiled",
    "data": {
      "customerId": "7100987614",
    }
    "errors": [],
}