Skip to main content
POST
/
api
/
customers
/
create-customer
curl -X POST 'https://crypto-api.yativo.com/api/customers/create-customer' \
  -H 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{
    "email": "jane@example.com",
    "first_name": "Jane",
    "last_name": "Doe",
    "phone": "+14155552671"
  }'

{
  "status": true,
  "message": "Customer created successfully",
  "data": {
    "_id": "cust_67e54665e759c943cd376abc",
    "username": "new_customer",
    "email": "customer@example.com",
    "phone_number": "",
    "user_id": "usr_6615c3a1e55d9ff7bc0a1234",
    "createdAt": "2026-03-28T10:00:00.000Z",
    "updatedAt": "2026-03-28T10:00:00.000Z"
  }
}
​
Authorization
string
required
Bearer token: Bearer YOUR_ACCESS_TOKEN
​
email
string
required
The customer’s email address. Must be unique within your account.
​
first_name
string
required
Customer’s legal first name.
​
last_name
string
required
Customer’s legal last name.
​
phone
string
Customer’s phone number in E.164 format (e.g. +14155552671).
​
metadata
object
Arbitrary key-value pairs you can attach to the customer for your own reference.
interface CreateCustomerRequest {
  email: string;
  first_name: string;
  last_name: string;
  phone?: string;
  metadata?: Record<string, string>;
}

interface CreateCustomerResponse {
  status: "success";
  data: {
    id: string;
    email: string;
    first_name: string;
    last_name: string;
    phone?: string;
    status: "pending";
    kyc_status: "not_started";
    created_at: string;
  };
}

curl -X POST 'https://crypto-api.yativo.com/api/customers/create-customer' \
  -H 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{
    "email": "jane@example.com",
    "first_name": "Jane",
    "last_name": "Doe",
    "phone": "+14155552671"
  }'

{
  "status": true,
  "message": "Customer created successfully",
  "data": {
    "_id": "cust_67e54665e759c943cd376abc",
    "username": "new_customer",
    "email": "customer@example.com",
    "phone_number": "",
    "user_id": "usr_6615c3a1e55d9ff7bc0a1234",
    "createdAt": "2026-03-28T10:00:00.000Z",
    "updatedAt": "2026-03-28T10:00:00.000Z"
  }
}