API Referencev1Customers

Create a customer

POST
/v1/customers
X-API-Key<token>

Per-store API key created in the dashboard at Settings > Developer > API Keys.

In: header

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

curl -X POST "https://api.whatalo.com/v1/customers" \  -H "Content-Type: application/json" \  -d '{    "name": "María García"  }'
{
  "data": {
    "id": "365047281936",
    "name": "María García",
    "email": "[email protected]",
    "phone": "+18091234567",
    "notes": "string",
    "has_email": true,
    "has_phone": true,
    "display_contact": "[email protected]",
    "created_at": "string",
    "updated_at": "string",
    "orders_count": 12,
    "total_spent": 1500.5,
    "last_order_at": "2026-04-15T14:30:00Z",
    "last_order_id": "order_pubid_xyz"
  }
}
{
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "Invalid request body",
    "details": [
      {
        "field": "string",
        "message": "string"
      }
    ]
  }
}