POST
Create Customer
Register a new customer profile on the hexCore platform without instantly generating an account number.
POST/v2/customer/create
Use this endpoint if your application flow requires you to decouple customer creation from account creation. You can create the customer profile first, and generate accounts or link services to them later.
Headers
| Header | Required | Description |
|---|---|---|
Authorization | YES | Bearer token containing your secret API key. |
Content-Type | YES | Must be set to application/json. |
Body Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
first_name | string | YES | The customer's legal first name. |
last_name | string | YES | The customer's legal last name. |
email | string | YES | The customer's primary email address. |
phone_number | string | YES | The customer's phone number in international format. |
dob | string | NO | Date of Birth in YYYY-MM-DD format. |
gender | string | NO | MALE or FEMALE. |
Example Request
cURL
curl -X POST "https://sandbox.hexcore.io/v2/customer/create" \-H "Authorization: Bearer sk_test_your_secret_key" \-H "Content-Type: application/json" \-d '{ "first_name": "Samuel", "last_name": "Smith", "email": "sam.smith@example.com", "phone_number": "+2348098765432", "dob": "1990-05-15", "gender": "MALE" }'Example Response
JSON (201 Created)
{"status": true,"message": "Customer created successfully","data": {"customer_id": "cus_8f92jdl29skw","first_name": "Samuel","last_name": "Smith","email": "sam.smith@example.com","created_at": "2026-05-01T15:00:00Z"} }