POST
Account Creation
Create a new customer account or virtual account on the hexCore platform.
POST/v2/account/create
This endpoint allows you to onboard a new user and generate a unique account number. You can specify the account tier based on the KYC level you have collected from the customer.
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 first name. |
last_name | string | YES | The customer's last name. |
bvn | string | NO | Bank Verification Number. Required for Tier 3 accounts. |
email | string | YES | Customer's email address for receiving notifications. |
phone_number | string | YES | Customer's phone number in international format (e.g. +234...). |
Example Request
cURL
curl -X POST "https://sandbox.hexcore.io/v2/account/create" \-H "Authorization: Bearer sk_test_your_secret_key" \-H "Content-Type: application/json" \-d '{ "first_name": "Jane", "last_name": "Doe", "email": "jane.doe@example.com", "phone_number": "+2348012345678", "bvn": "22222222222" }'Example Response
JSON (201 Created)
{"status": true,"message": "Account created successfully","data": {"account_number": "1234567890","account_name": "JANE DOE","bank_name": "HexCore Bank","tier": 3,"status": "ACTIVE"} }