POST
/
v2.01
/
{ClientId}
/
users
/
legal
{
    "UserCategory": "PAYER",
    "TermsAndConditionsAccepted": false,
    "LegalPersonType": "BUSINESS",
    "Name": "Best Business",
    "Email": "best.business@example.com",
    "LegalRepresentativeFirstName": "Alex",
    "LegalRepresentativeLastName": "Smith",
    "LegalRepresentativeAddress": {
        "AddressLine1": "3 rue de la Cité",
        "AddressLine2": "Appartement 7",
        "City": "Paris",
        "Region": "Île-de-France",
        "PostalCode": "75004",
        "Country": "FR"
    },
    "Tag": "Created using Mangopay API Postman collection"
}

{
    "HeadquartersAddress": {
        "AddressLine1": null,
        "AddressLine2": null,
        "City": null,
        "Region": null,
        "PostalCode": null,
        "Country": null
    },
    "LegalRepresentativeAddress": {
        "AddressLine1": "3 rue de la Cité",
        "AddressLine2": "Appartement 7",
        "City": "Paris",
        "Region": "Île-de-France",
        "PostalCode": "75004",
        "Country": "FR"
    },
    "Name": "Best Business",
    "LegalPersonType": "BUSINESS",
    "LegalRepresentativeFirstName": "Alex",
    "LegalRepresentativeLastName": "Smith",
    "LegalRepresentativeEmail": null,
    "LegalRepresentativeBirthday": null,
    "LegalRepresentativeNationality": null,
    "LegalRepresentativeCountryOfResidence": null,
    "ProofOfRegistration": null,
    "ShareholderDeclaration": null,
    "Statute": null,
    "LegalRepresentativeProofOfIdentity": null,
    "CompanyNumber": null,
    "PhoneNumber": null,
    "PhoneNumberCountry": null,
    "Id": "user_m_01JHX3QCQ38ZC0S52Y1TNGHGAN",
    "Tag": "Created using Mangopay API Postman collection",
    "CreationDate": 1737217520,
    "PersonType": "LEGAL",
    "Email": "best.business@example.com",
    "KYCLevel": "LIGHT",
    "TermsAndConditionsAccepted": false,
    "TermsAndConditionsAcceptedDate": null,
    "UserCategory": "PAYER",
    "UserStatus": "ACTIVE"
}

Note – Country-based restrictions apply to users

Due to Mangopay’s country restrictions, it is not possible to use blocked countries as the following:

  • HeadquartersAddress.Country
  • LegalRepresentativeNationality
  • LegalRepresentativeCountryOfResidence
  • LegalRepresentativeAddress.Country

​
Body parameters

​
UserCategory
string
required

Allowed values: PAYER, OWNER

The category of the user:

  • PAYER – User who can only make pay-ins to their wallets and transfers to other wallets.
  • OWNER – User who can also receive transfers to their wallets. Owners are able to request KYC verification, which if successful gives them the KYCLevel of REGULAR and the ability to request payouts.
​
TermsAndConditionsAccepted
boolean
required

Whether the user has accepted Mangopay’s terms and conditions (as defined by your contract, see the T&Cs guide for details).

Must be true if UserCategory is OWNER.

​
LegalPersonType
string
required

Allowed values: BUSINESS, PARTNERSHIP, ORGANIZATION, SOLETRADER

The type of legal user. For information on which LegalPersonType to use for a particular local legal structure, see the verification requirements.

Caution: Modification of the LegalPersonType may result in a verification downgrade.

​
Name
string
required

Max. length: 255 characters

The registered legal name of the entity. The Name value should be the one registered with the relevant national authority.

​
Email
string
required

Format: A valid email address

The email address for the entity.

​
HeadquartersAddress
object

Required if UserCategory is OWNER. Child parameters returned null if UserCategory is PAYER.

The legally registered address of the entity’s administrative center.

​
CompanyNumber
string

Required if UserCategory is OWNER and LegalPersonType is BUSINESS. Returned null if UserCategory is PAYER.

The registration number of the entity, assigned by the relevant national authority. For information on the expected format for a specific country, see the Company number guide. To validate the format of a number before submitting documents for verification, use POST Validate the format of User data.

​
LegalRepresentativeFirstName
string
required

Min length: 1; max. length: 100

The first name of the entity’s legal representative.

​
LegalRepresentativeLastName
string
required

Min length: 1; max. length: 100

The last name of the entity’s legal representative.

​
LegalRepresentativeEmail
string

Format: A valid email address

The email address of the entity’s legal representative.

Returned null if UserCategory is PAYER.

​
LegalRepresentativeBirthday
timestamp

Required if UserCategory is OWNER. Returned null if UserCategory is PAYER.

The date of birth of the entity’s legal representative.

Note: This is a Unix timestamp in UTC. Ensure you convert your timezone to UTC to avoid midnight being interpreted as the day before.

​
LegalRepresentativeNationality
string

Format: Two-letter country code (ISO 3166-1 alpha-2 format)

Required if UserCategory is OWNER. Returned null if UserCategory is PAYER.

The nationality of the entity’s legal representative.

​
LegalRepresentativeCountryOfResidence
string

Format: Two-letter country code (ISO 3166-1 alpha-2 format)

Required if UserCategory is OWNER. Returned null if UserCategory is PAYER.

The country of residence of the entity’s legal representative.

​
LegalRepresentativeAddress
object

The address of the entity’s legal representative.

​
Tag
string

Max. length: 255 characters

Custom data that you can add to this object.

​
Responses

{
    "HeadquartersAddress": {
        "AddressLine1": null,
        "AddressLine2": null,
        "City": null,
        "Region": null,
        "PostalCode": null,
        "Country": null
    },
    "LegalRepresentativeAddress": {
        "AddressLine1": "3 rue de la Cité",
        "AddressLine2": "Appartement 7",
        "City": "Paris",
        "Region": "Île-de-France",
        "PostalCode": "75004",
        "Country": "FR"
    },
    "Name": "Best Business",
    "LegalPersonType": "BUSINESS",
    "LegalRepresentativeFirstName": "Alex",
    "LegalRepresentativeLastName": "Smith",
    "LegalRepresentativeEmail": null,
    "LegalRepresentativeBirthday": null,
    "LegalRepresentativeNationality": null,
    "LegalRepresentativeCountryOfResidence": null,
    "ProofOfRegistration": null,
    "ShareholderDeclaration": null,
    "Statute": null,
    "LegalRepresentativeProofOfIdentity": null,
    "CompanyNumber": null,
    "PhoneNumber": null,
    "PhoneNumberCountry": null,
    "Id": "user_m_01JHX3QCQ38ZC0S52Y1TNGHGAN",
    "Tag": "Created using Mangopay API Postman collection",
    "CreationDate": 1737217520,
    "PersonType": "LEGAL",
    "Email": "best.business@example.com",
    "KYCLevel": "LIGHT",
    "TermsAndConditionsAccepted": false,
    "TermsAndConditionsAcceptedDate": null,
    "UserCategory": "PAYER",
    "UserStatus": "ACTIVE"
}

{
    "UserCategory": "PAYER",
    "TermsAndConditionsAccepted": false,
    "LegalPersonType": "BUSINESS",
    "Name": "Best Business",
    "Email": "best.business@example.com",
    "LegalRepresentativeFirstName": "Alex",
    "LegalRepresentativeLastName": "Smith",
    "LegalRepresentativeAddress": {
        "AddressLine1": "3 rue de la Cité",
        "AddressLine2": "Appartement 7",
        "City": "Paris",
        "Region": "Île-de-France",
        "PostalCode": "75004",
        "Country": "FR"
    },
    "Tag": "Created using Mangopay API Postman collection"
}

Was this page helpful?

The Legal User objectUpdate a Legal User