Create a Connected Account

POST 
/v1/connected-accounts

Creates a connected account for a seller from a standard primary account. Authenticate with the primary account Secret API Key; the key determines the owning account and the test or live mode.

The response includes the public account object and the ONVO-hosted onboardingUrl. The seller must complete that flow before operating.

Request

Responses

201

Connected account created.

400

Invalid payload, unsupported field, or invalid primary account configuration.

401

Invalid Secret API Key, disallowed Publishable API Key, or live key for an inactive primary account.

500

Onboarding link creation failed. The transaction does not leave a partial connected account.