Individual

For complete API specification, see the API Reference.

Individual customers represent personal accounts for consumer applications. You can create them with minimal data (even an empty object {}) and enrich their profiles later through widget flows or API updates.

Create

Not authenticated•Authenticate first

POST/v1/customers

Copy as

Creates a new individual customer account. Returns a unique identifier for subsequent operations.

Use Cases

Scenario	Approach	Benefits
Widget-based onramp	Create with `{}`	Fastest integration, user fills data in widget
Pre-filled profile	Include firstName, lastName, email, phone	Better UX, fewer steps for user
KYC import	Add `shareToken` from SumSub	Skip redundant verification

Key Features

Minimal Data Required

You can create a customer with absolutely no data:

{}

This is perfect for widget-based flows where the user will fill in their information through the UI.

Optional Profile Data

Enhance the user experience by pre-filling customer information:

{
  "firstName": "John",
  "lastName": "Doe",
  "email": "john@example.com",
  "phone": "+1234567890"
}

KYC Import

If you already have KYC verification from SumSub, import it with a share token:

{
  "firstName": "John",
  "lastName": "Doe",
  "email": "john@example.com",
  "shareToken": "sumsub_token_xyz"
}

Response

{
  "id": "cus_abc123",
  "type": "individual",
  "status": "approved",
  "email": "john@example.com",
  "firstName": "John",
  "lastName": "Doe",
  "createdAt": "2025-04-29T10:13:07.826Z",
  "updatedAt": "2025-04-29T10:13:07.826Z"
}

Next Steps

After creating a customer:

Create a wallet - Set up multi-chain wallet infrastructure
Initiate pay-in - Fund the wallet via crypto or fiat payment methods
Manage customer - Update profile, check balance, manage lifecycle

Create business customer - For B2B applications
Customer Management - Advanced customer operations
API Reference - Complete API documentation

On this page