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

# Create Person

`POST /tree/persons`

## Request

- Base URL: `https://apibeta.familysearch.org/platform`
- URL: `https://apibeta.familysearch.org/platform/tree/persons`
- Auth: HTTP bearer

Create a person.

## 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

- CreatePerson
  - `persons` object[], required: Array containing exactly one person to create. See <a href="https://developers.familysearch.org/main/docs/json-schema#person" target="_blank">Person Schema (JSON)</a>
    - `living` boolean: Whether the person is living. Set to false for deceased persons.
    - `gender` object: The gender of the person
      - `type` string: The type URI for the gender
    - `names` object[]: Array of names for the person. Do not include id fields when creating a new person.
      - `type` string: The type of name
      - `preferred` boolean: Whether this is the preferred name
      - `nameForms` object[]: Array of name forms representing the name in different languages or scripts
        - `fullText` string: The full text of the name
        - `parts` object[]: Array of name parts (given name, surname, etc.)
          - `type` string: The type of name part
          - `value` string: The value of the name part
    - `facts` object[]: Array of facts about the person (birth, death, residence, etc.). Do not include id fields when creating a new person.
      - `type` string, required: The type of fact
      - `date` object: The date of the fact
        - `original` string: The original date string as entered
        - `formal` string: The formal standardized date (optional, will be calculated if omitted)
      - `place` object: The place of the fact
        - `original` string: The original place string as entered

## Response `201`

The creation of the 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/family-tree-endpoints.md) - [All operations](https://skmtc.dev/familysearch/apis/family-tree-endpoints/llms.txt) - [OpenAPI document](https://skmtc.dev/familysearch/apis/family-tree-endpoints/revisions/e248abd029e6?raw)