Skip to main content

Create User Account

POST 
/v1/users/accounts

Create an user account. User account is a base for all others entities. It must be created as first entity.

Request​

Header Parameters

    x-transaction-uuid stringrequired

    The transaction ID is a UUID (v4) used to uniquely identify the object that will be created. All objects must have an identifier.

    nonce stringrequired

    The nonce ID is a UUID (v4) used to uniquely identify the request. All requests must have an identifier.

    x-lang string

    Possible values: [pt-BR, en-US]

    Indicates the preferred language. Defaults to Brazilian Portuguese if unspecified.

    x-product-uuid stringrequired

    The product ID is a UUID (v4) used to identify the Z.ro product configuration.

    x-product-target-user-uuid string

    The product target user ID is a UUID (v4) used to identify what user account this request must be executed. Require: x-product-uuid.

Body

required
    name stringrequired

    User short name or company trade name.

    full_name stringrequired

    User full name or company name.

    genre string

    Possible values: [male, female, non_binary, other, prefer_not_to_say]

    User gender:

    • female.
    • male.
    • non_binary.
    • other.
    • prefer_not_to_say.

    mother_name string

    User mother name.

    birth_date date-time

    User birth date.

    document stringrequired

    User CPF or company CNPJ (only numbers)

    phone_number string

    User or company phone number. At least one contact detail (email or phone number)

    email string

    User or company e-mail. At least one contact detail (email or phone number)

    active booleanrequired

    User should start as active?

    person_type stringrequired

    Possible values: [NATURAL_PERSON, LEGAL_PERSON]

    Person type:

    • NATURAL_PERSON.
    • LEGAL_PERSON.

    legal_person_type string

    Possible values: [MEI, EI, SLU, LTDA, SS, SA]

    Legal type:

    • EI.
    • LTDA.
    • MEI.
    • SA.
    • SLU.
    • SS.

Responses​

User account created.

Schema
    id stringrequired

    User account ID.

    state stringrequired

    Possible values: [pending, active, expired, deactivated]

    User state.

    created_at date-timerequired

    User created date.

Loading...