Customers
Add a wallet transaction
Authorization
apiKey AuthorizationBearer <token>
Per-organisation API key from Settings → API Keys, sent as Authorization: Bearer cnk_…. Missing, unknown or expired keys return 401.
In: header
Path Parameters
id*string
Customer id.
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://example.com/customers/cus_abc123/wallet" \ -H "Content-Type: application/json" \ -d '{ "type": "CREDIT", "amount": 250, "notes": "Migration goodwill top-up" }'{ "statusCode": 200, "statusDetail": { "status": "SUCCESS", "message": "OK" }, "result": { "transaction": { "id": "wtx_4c8d2e", "type": "CREDIT", "amount": 250, "amountUsd": 250, "currencyCode": "USD", "currencyRateUsd": 1, "notes": "Migration goodwill top-up", "batchId": "string", "createdAt": "2026-07-15T10:20:00.000Z", "createdByName": "Priya N." }, "balanceUsd": 262.5 }}{ "statusCode": 400, "statusDetail": { "status": "ERROR", "message": "Request body must be valid JSON." }, "result": {}}{ "statusCode": 401, "statusDetail": { "status": "ERROR", "message": "Invalid API key." }, "result": {}}{ "statusCode": 404, "statusDetail": { "status": "ERROR", "message": "No customer with id \"cus_abc123\"." }, "result": {}}{ "statusCode": 422, "statusDetail": { "status": "ERROR", "message": "No credit with agent key \"summarize\" exists in this workspace." }, "result": {}}{ "statusCode": 500, "statusDetail": { "status": "ERROR", "message": "Could not complete the request." }, "result": {}}