---
title: "Create Genealogies Person"
method: POST
path: "/genealogies/trees/{tid}/persons"
tags: ["Person"]
---

# Create Genealogies Person

`POST /genealogies/trees/{tid}/persons`

## Request

- Base URL: `https://apibeta.familysearch.org/platform`
- URL: `https://apibeta.familysearch.org/platform/genealogies/trees/{tid}/persons`
- Auth: HTTP bearer

Create a genealogies person in the specified genealogies tree.

## Path parameters

- `tid` string, required

## Headers

- `Content-Type` 'application/x-fs-v1+json' | 'application/x-gedcomx-v1+json' | 'application/x-fs-v1+xml' | 'application/x-gedcomx-v1+xml', required
- `X-Reason` string

## Request body

- CreateGenealogiesPerson
  - `persons` object[], required: Array containing exactly one person to be created. See <a href="https://developers.familysearch.org/main/docs/json-schema#person" target="_blank">Person Schema (JSON)</a>
    - `id` string, required: A local, context-specific id for the person. This is required for person creation and is used to reference the person within the same request.
    - `living` boolean: Whether the person is living or deceased.
    - `gender` object: The gender of the person.
      - `type` string: The gender type URI. Common values: http://gedcomx.org/Male, http://gedcomx.org/Female, http://gedcomx.org/Unknown.
    - `names` object[]: Array of names for the person.
      - `type` string: The name type URI. Common value: http://gedcomx.org/BirthName.
      - `preferred` boolean: Whether this is the preferred name.
      - `nameForms` object[]: Array of name forms representing different representations of the name (e.g., different languages or scripts).
        - `fullText` string: The full text of the name.
        - `parts` object[]: Array of name parts.
          - `type` string: The name part type URI. Common values: http://gedcomx.org/Given, http://gedcomx.org/Surname.
          - `value` string: The value of the name part.
    - `facts` object[]: Array of facts about the person (e.g., birth, residence, death).
      - `type` string: The fact type URI. Common values: http://gedcomx.org/Birth, http://gedcomx.org/Death, http://gedcomx.org/Residence.
      - `date` object: The date of the fact.
        - `original` string: The original date string as entered by the user.
        - `formal` string: The formal date representation (ISO 8601 or GEDCOM X format).
      - `place` object: The place of the fact.
        - `original` string: The original place string as entered by the user.
    - `attribution` object: Attribution information for the person creation.
      - `changeMessage` string: A message describing the reason for creating the person.

## Response `201`

The creation of the genealogies person was successful. Expect a location header specifying the link to the created person.

## Other responses

- `429`: The request was throttled.

---

[API](https://skmtc.dev/familysearch/apis/genealogies-endpoints.md) - [All operations](https://skmtc.dev/familysearch/apis/genealogies-endpoints/llms.txt) - [OpenAPI document](https://skmtc.dev/familysearch/apis/genealogies-endpoints/revisions/0084dedb6ce0?raw)