---
title: "Create Person"
method: POST
path: "/persons"
tags: ["Persons"]
---

# Create Person

`POST /persons`

## Headers

- `LMG-Data-Privacy-Access-Principal` string, required
- `LMG-Data-Privacy-Access-Justification` string, required

## Request body

- PersonRequest
  - `firstname` string, required — A string describing the person's first name.
  - `lastname` string, required — A string describing the person's lastname.
  - `date_of_birth` string, date, required — A string describing the day of birth, like `"1964-08-13"`.
  - `registered_address` AddressRequest, required
    - `line_1` string, required — The first line of the address. For most German addresses, this will be the street name and house number. If there is only a street name or a house number, provide that one without the other.
    - `line_2` string — The second line of the address. This field is optional, and it won't be needed for most German addresses. For care-of addresses (℅) like the following, this is likely to be the actual street name and house number: <br/> * Erika Mustermann<br/>℅ Max Müller<br/>**Mustergasse 14**<br/>12345 Musterstadt<br/>Germany
    - `postal_code` string, required — The postal code for the address.
    - `city` string, required — The city/municipality of the address.
    - `country` string, required — An ISO 3166-1 alpha-2 code, representing the country of the address.
  - `nationalities` string[] — A **complete** list of ISO 3166-1 alpha-2 codes, representing each country related to a user's nationalities/citizenships. It is important for this data point to be complete.
  - `email` string, email — A verified email address to contact the user. This email address must match the one you have on record for the user.
  - `phone_number` string — A mobile phone number, including the country calling code.
  - `place_of_birth` BusinessPersonPlaceOfBirthRequest — An object representing a place of birth.
    - `city` string — The city/municipality of the place of birth.
    - `country` string, required — An ISO 3166-1 alpha-2 code, representing the country related to the place of birth.
  - `tax_residencies` TaxResidency[] — A list of a person's tax residencies. It is important for this data point to be complete.
    - `country` string, required — An ISO 3166-1 alpha-2 code, representing a country considering the user one of its tax payers.
    - `tax_identification_number` string — The TIN (Tax Identification Number) related to the user within the taxation regime within `country`.
  - `accepted_agreements` BrokerAppsApiEndpointsAgreementsAgreementAcceptanceRequest[], required — A list of legal agreements that have been accepted by the person.
    - `agreement_id` string, required — An agreement identifier. This value identifies the agreement that a customer has accepted at a certain point in time.
    - `accepted_at` string, date-time, required — A point in time. This value specifies the point in time at which the user accepted the agreement referenced by `agreement_id`.

## Response `201`

Successful Response

- BrokerAppsApiEndpointsPersonsPersonResponse
  - `id` string, required — The identifier representing this person.
  - `firstname` string, required — A string describing the person's first name.
  - `lastname` string, required — A string describing the person's lastname.
  - `date_of_birth` string, date, required — A string describing the day of birth, like `"1964-08-13"`.
  - `registered_address` Address, required — A residential address.
    - `line_1` string, required — The first line of the address. For most German addresses, this will be the street name and house number. If there is only a street name or a house number, provide that one without the other.
    - `line_2` string — The second line of the address. This field is optional, and it won't be needed for most German addresses. For care-of addresses (℅) like the following, this is likely to be the actual street name and house number: <br/> * Erika Mustermann<br/>℅ Max Müller<br/>**Mustergasse 14**<br/>12345 Musterstadt<br/>Germany
    - `postal_code` string, required — The postal code for the address.
    - `city` string, required — The city/municipality of the address.
    - `country` string, required — An ISO 3166-1 alpha-2 code, representing the country of the address.
  - `nationalities` string[] — A **complete** list of ISO 3166-1 alpha-2 codes, representing each country related to a user's nationalities/citizenships. It is important for this data point to be complete.
  - `email` string — A verified email address to contact the user. This email address must match the one you have on record for the user.
  - `phone_number` string — A mobile phone number, including the country calling code.
  - `place_of_birth` PlaceOfBirthRequest — An object representing a place of birth.
    - `city` string, required — The city/municipality of the place of birth.
    - `country` string, required — An ISO 3166-1 alpha-2 code, representing the country related to the place of birth.
  - `tax_residencies` TaxResidency[] — A **complete** list of all of a user's tax residencies. It is important for this data point to be complete.
    - `country` string, required — An ISO 3166-1 alpha-2 code, representing a country considering the user one of its tax payers.
    - `tax_identification_number` string — The TIN (Tax Identification Number) related to the user within the taxation regime within `country`.

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `404` — Not Found
- `422` — Unprocessable Entity
- `5XX` — Server Error

---

[API](https://skmtc.net/lemon/apis/lemon-markets-brokerage-api.md) · [All operations](https://skmtc.net/lemon/apis/lemon-markets-brokerage-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/lemon/lemon-markets-brokerage-api/versions/3c8cfd3a96c9/schema)