Skip to main content
Create a customer record before initiating any KYC verification or payments for that customer. 
POST /customer
Requires Idempotency-Key header.

​
Request body

​
customer_name
string
required
Full name of the customer (individual) or legal business name (business).
​
customer_email
string
required
Customer’s email address. Must be unique per account.
​
customer_phone
string
required
Customer’s phone number in E.164 format (e.g. +15551234567).
​
customer_country
string
required
Customer’s country of residence in ISO 3166-1 alpha-3 format (e.g. USA, BRA, MEX).
​
customer_type
string
Customer type: "individual" or "business". Defaults to "individual".
curl -X POST 'https://api.yativo.com/api/v1/customer' \
  -H 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
  -H 'Content-Type: application/json' \
  -H 'Idempotency-Key: create-customer-alex-smith-001' \
  -d '{
    "customer_name": "Alex Smith",
    "customer_email": "alex.smith@example.com",
    "customer_phone": "+15551234567",
    "customer_country": "USA",
    "customer_type": "individual"
  }'

{
  "status": "success",
  "status_code": 201,
  "message": "Customer created successfully",
  "data": {
    "customer_id": "c586066b-0f29-468f-b775-15483871a202",
    "customer_name": "Alex Smith",
    "customer_email": "alex.smith@example.com",
    "customer_phone": "+15551234567",
    "customer_country": "USA",
    "customer_type": "individual",
    "customer_status": "active",
    "created_at": "2026-04-02T10:00:00.000000Z"
  }
}