KivooDeveloper
GuidesRéférenceWebhooksDashboardkivoo.africa

Create a customer

Portée requisecustomers:writeLa clé API doit porter cette portée, sinon Kivoo répond 403 insufficient_scope.
POST/v1/customers

Add 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.

Autorisation

apiKey
AuthorizationBearer <clé API>

Clé API de la boutique, kv_live_…

Dans: header

Corps de la requête

application/json

Définitions TypeScript

Utilise le type request body en TypeScript.

Corps de la réponse

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