CustomersCreate Customer

Create Customer

This endpoint allows you to register a new customer on the platform by submitting essential information such as email, name, and phone number, along with any additional optional details.

Standalone customer creation remains supported. If your immediate goal is to create a reserved virtual account, you can instead create the customer and dedicated account in one request by sending the customer’s details to the dedicated virtual-account endpoint.

API Endpoint

POST https://backendapi.sayswitchgroup.com/api/v1/customer

Sample Request

curl -X POST https://backendapi.sayswitchgroup.com/api/v1/customer
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_SECRET_KEY" \
  -d '{
    "email": "test@email.com",
    "first_name": "test",
    "last_name": "tester",
    "phone": "08159994269"
  }'

Request Explanation

FieldsTypeDescription
emailstringThe customer’s valid email address.
first_namestringThe customer’s given name.
last_namestringThe customer’s surname or family name.
phonestringThe customer’s primary phone number.

Sample Response

{
"success": true,
"message": "Customer created",
"data": {
  "email": "test@email.com",
  "domain": "test",
  "customer_code": "CUS_8n9f689gok7obwg",
  "id": 330,
  "created_at": "2025-05-13T14:35:44.000000Z",
  "updated_at": "2025-05-13T14:35:44.000000Z"
}
}