ReferenceCustomers
Create a customer
Required scope
customers:writeThe API key must hold this scope, otherwise Kivoo answers 403 insufficient_scope.POST
/v1/customersAdd a buyer with an email, a phone, or both. A buyer the store already knows by that email or phone is returned with 200 (and completed with what it lacked), never duplicated; a new one with 201.
Authorization
apiKey AuthorizationBearer <token>
Clé API de la boutique, kv_live_…
In: header
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/json
application/json
application/json
application/json
application/json
curl -X POST "https://api.kivoo.africa/v1/customers" \ -H "Authorization: Bearer kv_live_EXAMPLE0000000000000000000000000000000000" \ -H "Content-Type: application/json" \ -d '{ "name": "Aminata Diallo", "email": "aminata@example.com", "phone": "+237655000000" }'{ "id": "7d9e1f2a-3b4c-4d5e-8f6a-7b8c9d0e1f2a", "name": "Aminata Diallo", "email": "aminata@example.com", "phone": "+237655000000", "ordersCount": 3, "totalPaid": 15000, "currency": "XAF", "createdAt": "2026-09-12T10:03:00.000Z"}