Create user or retry KYC

Production

POST

/v1/brla/createSubaccount

companyName, startDate and cnpj are only required when taxIdType is CNPJ

quoteId is optional: pass it in the normal ramp flow, or omit it for the quote-less KYB deep link where business verification starts before any quote exists.

Auth: uses optionalAuth — accepts a Supabase Bearer token if present but does not require one.

Request

Body Params application/json

Examples

Responses

🟢200

application/json

Subaccount created or KYC retry initiated successfully.

Bodyapplication/json

🟠400

🔴500

Request Example

Shell

JavaScript

Java

Swift

curl --location '/v1/brla/createSubaccount' \
--header 'Content-Type: application/json' \
--data '{
    "address": {
        "cep": "string",
        "city": "string",
        "complement": "string",
        "district": "string",
        "number": "string",
        "state": "string",
        "street": "string"
    },
    "birthdate": "2019-08-24",
    "cnpj": "string",
    "companyName": "string",
    "cpf": "string",
    "fullName": "string",
    "phone": "string",
    "quoteId": "string",
    "startDate": "2019-08-24",
    "taxIdType": "CPF"
}'

Response Example

200 - Example 1

{
    "subaccountId": "string"
}

Modified at 2026-07-17 17:44:02

Delete Webhook

Get user's KYC status