Skip to main content
POST
/
api
/
customers
curl -X POST 'https://crypto-api.yativo.com/api/customers' \
  -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": "success",
  "data": {
    "id": "cust_01HX9KZMB3F7VNQP8R2WDGT4E5",
    "email": "jane@example.com",
    "first_name": "Jane",
    "last_name": "Doe",
    "phone": "+14155552671",
    "status": "pending",
    "kyc_status": "not_started",
    "created_at": "2026-03-26T10:00:00Z"
  }
}
​
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' \
  -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": "success",
  "data": {
    "id": "cust_01HX9KZMB3F7VNQP8R2WDGT4E5",
    "email": "jane@example.com",
    "first_name": "Jane",
    "last_name": "Doe",
    "phone": "+14155552671",
    "status": "pending",
    "kyc_status": "not_started",
    "created_at": "2026-03-26T10:00:00Z"
  }
}