Create a new user

POST https://api.balampay.com/sandbox/v1/users

Create a new user (individual or business) in the system.

Automatic Verification: When a user is created with all required fields, Kira automatically triggers identity verification (KYC/KYB) in the background:

1. No additional API calls needed - Verification starts automatically
2. Faster onboarding - Users don't need to complete a separate verification step
3. Webhook notifications - You'll receive user.verification.accepted or user.verification.failed events

The response includes a verification_triggered field indicating whether automatic verification was started.

Required Fields for Automatic Verification:

Individual Users (USA):

• first_name, last_name, birth_date, email
• address_street, address_city, address_state, address_zip_code, address_country
• identifying_information with type 'ssn'
• identifying_information with Government ID + documents

Business Users (USA):

• business_legal_name, email, business_type, ein
• representative_first_name, representative_last_name
• Full address fields
• associated_persons with Government IDs

Authentication: Both x-api-key header and Authorization: Bearer <token> header are required.