Skip to main content
POST
/
api
/
external
/
customer
curl --request POST \ --url https://api-prod.blaaiz.com/api/external/customer \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data ' { "type": "individual", "first_name": "John", "last_name": "Doe", "email": "john.doe@company.com", "country": "NG", "id_type": "passport", "id_number": "6733823632872", "phone": "+2348012345678", "dob": "1990-01-15", "street": "123 Main Street", "city": "Lagos", "state": "Lagos", "zip_code": "100001", "id_expiry_date": "2030-01-15", "id_issue_date": "2020-01-15" } '
{
  "message": "Customer created successfully.",
  "data": {
    "id": "9d4c4ec5-59ea-4130-bf8a-6a5edec401ee",
    "business_id": "9d4c4ec5-572d-49de-a362-f01ed09f2b1b",
    "first_name": "John",
    "last_name": "Doe",
    "business_name": null,
    "type": "individual",
    "email": "john.doe@company.com",
    "country": "NG",
    "id_type": "passport",
    "id_number": "6733823632872",
    "verification_status": "PENDING"
  }
}

Authorizations

​
Authorization
string
header
required

Use your OAuth client credentials to obtain a short-lived Bearer token from POST /oauth/token.

Body

application/json
​
type
enum<string>
required

Customer type.

Available options:
individual,
business
​
email
string<email>
required
​
country
string
required

Country code (e.g., NG, CA, US). This must match the country on the identity document submitted for KYC.

​
id_type
enum<string>
required

ID type; certificate_of_incorporation only valid for business.

Available options:
drivers_license,
passport,
id_card,
resident_permit,
certificate_of_incorporation
​
id_number
string
required
​
first_name
string

Required if type is individual.

​
last_name
string

Required if type is individual.

​
business_name
string

Required if type is business.

​
phone
string
​
tin
string

Tax identification number (varies by country). Where applicable, use the Get Identification Type endpoint to determine the correct label or field to collect for the customer's country and type.

​
dob
string<date>
​
street
string
​
city
string
​
state
string
​
zip_code
string
​
id_expiry_date
string<date>
​
id_issue_date
string<date>

Response

Customer created successfully.

​
message
string
required
​
data
object
required