Skip to main content

Create Legal Representative (v4)

POST 
/v4/users/legal-representatives

Create a legal representative (partner, administrator, attorney, etc.) linked to a shareholder. Legal representatives are always natural persons that represent shareholders in the QSA structure.

Changed in v4 (compliance/KYC required data):

  • document_country is now required and no longer defaults to BRA.
  • income is now required.
  • participation_percentage is now required.

Version 3 keeps accepting the previous, looser payload and is deprecated.

Important:

  • Legal representatives are always natural persons
  • Must be linked to an existing shareholder via shareholder_id
  • Both email and phone_number are required
  • mother_name is required

Constraints:

  • shareholder_id must reference an existing shareholder from the authenticated legal person flow

Required documents (upload after creation):

  • selfie - Representative selfie photo
  • identity_document - ID, CNH or Passport
  • qualification_declaration - Declaration of powers

Related endpoint: POST /users/legal-representatives/{id}/documents.

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-product-uuid string

    UUID (v4) of the product that the request should use. Send it explicitly when the authenticated user has more than one product or when the integration must select a specific product. If omitted and the endpoint does not require it, the API uses the authenticated user's default product.

    x-product-target-user-uuid string

    UUID (v4) of the user on whose behalf the request should run within the selected product. If omitted, the request runs as the authenticated user. Requires x-product-uuid.

    x-lang string

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

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

Body

required
    name stringrequired

    Legal representative name.

    mother_name stringrequired

    Mother name.

    document stringrequired

    CPF number (only numbers).

    document_country stringrequired

    Document country of issue. There is no default anymore, send BRA for Brazilian documents.

    birth_date daterequired

    Birth date.

    income numberrequired

    Income in cents.

    patrimony number

    Patrimony in cents.

    participation_percentage numberrequired

    Participation percentage in management/representation (0 to 100).

    Note: This represents the legal representative's participation in legal person management, which may differ from their equity stake. If this legal representative is linked to a shareholder, the shareholder has its own participation_percentage representing equity stake.

    pep booleanrequired

    PEP self-declaration.

    is_public_server booleanrequired

    Public server flag.

    representor_type stringrequired

    Possible values: [PARTNER, ATTORNEY, ADMINISTRATOR, OTHER]

    Legal representative qualification.

    phone_number stringrequired

    Phone number.

    email stringrequired

    Email.

    relationship_start_date daterequired

    Relationship start date with the legal entity.

    relationship_end_date date

    Relationship end date with the legal entity.

    registration_update_date date

    Registration update date. If omitted, defaults to relationship_start_date.

    shareholder_id stringrequired

    Shareholder ID this legal representative is linked to. Required.

    Constraints:

    • The shareholder_id must reference an existing shareholder
    • The shareholder must belong to the same authenticated legal person (same user)

    Relationship:

    • Links the legal representative to a specific shareholder in the legal person structure
    • The legal representative can represent the shareholder in legal matters
    • Both entities can have different participation_percentage values:
      • Shareholder: equity stake in the legal person
      • Legal Representative: management participation percentage
    address objectrequired
    zip_code stringrequired

    User address zip code.

    street stringrequired

    User address street.

    number numberrequired

    User address number.

    neighborhood stringrequired

    User address neighborhood.

    city stringrequired

    User address city.

    federative_unit stringrequired

    User address federative unit.

    country stringrequired

    User address country.

    complement string

    User address complement.

Responses​

Legal representative created successfully. Proceed to upload required documents.

Schema
    id stringrequired

    Legal representative ID.

    document objectrequired
    id stringrequired

    Document ID.

    type stringrequired

    Possible values: [CPF]

    Document type.

    number stringrequired

    Document number.

    country_of_issue stringrequired

    Document country of issue.

    address objectrequired
    id stringrequired

    Address ID.

    zip_code stringrequired

    ZIP code.

    street stringrequired

    Street.

    number numberrequired

    Street number.

    neighborhood stringrequired

    Neighborhood.

    city stringrequired

    City.

    federative_unit stringrequired

    Federative unit.

    country stringrequired

    Country.

    complement string

    Address complement.

    name stringrequired

    Legal representative name.

    representor_type stringrequired

    Possible values: [PARTNER, ATTORNEY, ADMINISTRATOR, OTHER]

    Legal representative qualification.

    person_type stringrequired

    Possible values: [NATURAL_PERSON, LEGAL_PERSON]

    Person type.

    income numberrequired

    Income in cents.

    patrimony number

    Patrimony in cents.

    participation_percentage numberrequired

    Participation percentage.

    pep booleanrequired

    PEP flag.

    is_public_server booleanrequired

    Public server flag.

    phone_number stringrequired

    Phone number.

    email stringrequired

    Email.

    registration_update_date date-timerequired

    Registration update date.

    birth_date date-timerequired

    Birth date.

    relationship_start_date date-timerequired

    Relationship start date with the legal entity.

    relationship_end_date date-time

    Relationship end date with the legal entity.

    created_at date-timerequired

    Creation date.

    shareholder_id string

    Shareholder ID this legal representative is linked to.

Loading...