Create user
Registering a user on the platform requires only a few API calls. Below is the recommended happy-path flow for user creation and activation.
Use the initial onboarding endpoint to create the user and submit declarative information. Including as much data as possible increases the chances of automatic approval.
Optional if you already submitted full data in step 1. Otherwise, identify which fields are still required using the missing personal data endpoint and complete them using the relevant onboarding tasks.
Upload identity images once all mandatory information is complete to validate the user and finalize onboarding.
The user automatically transitions to ACTIVE once onboarding tasks are processed. Status updates are delivered via the webhook event USER_ONBOARDING_UPDATE.
Once the user reaches ACTIVE, they can operate on the platform and use any available payment flow.
For per-country payload examples and jurisdiction-specific rules, see Country requirements.
Broker users are created on the Broker API (https://api.manteca.dev/broker). The recommended happy-path flow:
- Create the user with
POST /v1/api/onboarding/initial, submittingemail,legalId,personalData, andbanking.accounts. Include as much data as possible to increase automatic approval. Optionally passfeeInfoId(fee group) andexternalId(your reference, returned on the user and on webhooks). - Complete the investor profile if required — fetch the questionnaire with
GET /v1/api/onboarding/investingQuizand submit answers withPOST /v1/api/onboarding/investingQuiz. - Upload identity documentation when needed: request an upload URL with
POST /v1/api/compliance/documentation/uploadUrl, thenPUTthe file binary to the returned pre-signed S3 URL. Individuals uploadDNI_FRONT,DNI_BACK,SELFIE; companies uploadBYLAWS,AUTHORITIES,STAKEHOLDERS,BALANCE(full company flow: Onboarding a company). The same endpoint takesFUNDS(proof of source of funds) later on, to raise the person's deposit ceiling — see Operating model → Deposit limits and source of funds. - Track activation with
GET /v1/api/onboarding/status/USERANYIDor theuser-status-updatewebhook. The user is ready to operate at statusACTIVE.
Compliance applies at the person (tax ID) level — review Operating model and the Broker as a Service section for the full integration.
Updated 22 days ago