> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.mangopay.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.mangopay.com/_mcp/server.

# API - Apr 16, 2026

## Changed

### User date of birth limited to 120 years ago

To ensure data quality and consistency, the age of a Natural User and the legal representative of a Legal User is now limited to a maximum of 120 years old.

The `Birthday` and `LegalRepresentative.Birthday` fields now return the error below if the Unix timestamp provided indicates an age older than 120 years.

This error may be returned on the following endpoints:

* [POST Create a Natural User (SCA)](/api-reference/users/create-natural-user-sca)

* [PUT Update a Natural User (SCA)](/api-reference/users/update-natural-user-sca)

* [PUT Categorize a Natural User](/api-reference/users/categorize-natural-user)

* [POST Create a Legal User (SCA)](/api-reference/users/create-legal-user-sca)

* [PUT Update a Legal User (SCA)](/api-reference/users/update-legal-user-sca)

* [PUT Categorize a Legal User](/api-reference/users/categorize-legal-user)

#### Natural User

```json
{
    "Message": "One or several required parameters are missing or incorrect. An incorrect resource ID also raises this kind of error.",
    "Type": "param_error",
    "Id": "e4d7f9d3-b94f-4e68-8963-aadb1a88510d",
    "Date": 1776244847.0,
    "errors": {
        "Birthday": "The Birthday value indicates an age over 120 years, which is not allowed."
    }
}
```

#### Legal User

```json
{
    "Message": "One or several required parameters are missing or incorrect. An incorrect resource ID also raises this kind of error.",
    "Type": "param_error",
    "Id": "eeb3c4ea-6cee-4475-84ee-1707b513f78d",
    "Date": 1776244858.0,
    "errors": {
        "LegalRepresentative.Birthday": "The Birthday value indicates an age over 120 years, which is not allowed."
    }
}
```