curl -X POST 'https://crypto-api.yativo.com/api/v1/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"
}'
const customer = await sdk.customers.create({
email: 'jane@example.com',
first_name: 'Jane',
last_name: 'Doe',
});
console.log('Customer ID:', customer.data.id);
{
"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"
}
}
WaaS Customers (Wallet Sub-accounts)
Create Customer
Register a new customer in your account
POST
/
v1
/
customers
/
create-customer
curl -X POST 'https://crypto-api.yativo.com/api/v1/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"
}'
const customer = await sdk.customers.create({
email: 'jane@example.com',
first_name: 'Jane',
last_name: 'Doe',
});
console.log('Customer ID:', customer.data.id);
{
"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"
}
}
string
required
Bearer token:
Bearer YOUR_ACCESS_TOKENstring
required
The customer’s email address. Must be unique within your account.
string
required
Customer’s legal first name.
string
required
Customer’s legal last name.
string
Customer’s phone number in E.164 format (e.g.
+14155552671).object
Arbitrary key-value pairs you can attach to the customer for your own reference.
Request/Response Type Definitions
Request/Response Type Definitions
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/v1/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"
}'
const customer = await sdk.customers.create({
email: 'jane@example.com',
first_name: 'Jane',
last_name: 'Doe',
});
console.log('Customer ID:', customer.data.id);
{
"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"
}
}