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"
  }
}

POST

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_TOKEN

string

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

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"
  }
}

List Customers Update Customer

Overview

Authentication

Accounts

Assets

Transactions

Swap

Yativo Card (Own Account)

Card Customer — Onboarding

Card Customer — Card Operations

Card Issuer Program

Payment Gateway

Agentic Wallets

Unified Transactions

Auto-Forwarding

Compliance Screener

Subscriptions

IBAN

Webhooks

WaaS Customers (Wallet Sub-accounts)

Analytics

API Keys

Create Customer