Create Person

This example request illustrates how to create a person.

JSON

Request

POST /platform/tree/persons
Content-Type: application/x-fs-v1+json
Authorization: Bearer YOUR_ACCESS_TOKEN_HERE{
  "persons" : [ {
    "living" : false,
    "gender" : {
      "attribution" : {
        "changeMessage" : "...change message..."
      },
      "type" : "http://gedcomx.org/Female"
    },
    "names" : [ {
      "attribution" : {
        "changeMessage" : "...change message..."
      },
      "type" : "http://gedcomx.org/BirthName",
      "preferred" : true,
      "nameForms" : [ {
        "fullText" : "Anastasia Aleksandrova",
        "parts" : [ {
          "type" : "http://gedcomx.org/Given",
          "value" : "Anastasia"
        }, {
          "type" : "http://gedcomx.org/Surname",
          "value" : "Aleksandrova"
        } ]
      }, {
        "fullText" : "Анастасия Александрова",
        "parts" : [ {
          "type" : "http://gedcomx.org/Given",
          "value" : "Анастасия"
        }, {
          "type" : "http://gedcomx.org/Surname",
          "value" : "Александрова"
        } ]
      } ]
    } ],
    "facts" : [ {
      "attribution" : {
        "changeMessage" : "...change message..."
      },
      "type" : "http://gedcomx.org/Birth",
      "date" : {
        "original" : "3 Apr 1836",
        "formal" : "+1836"
      },
      "place" : {
        "original" : "Moscow, Russia",
        "normalized" : [ {
          "lang" : "en",
          "value" : "Moscow, Moskva, Russia"
        } ]
      }
    }, {
      "attribution" : {
        "changeMessage" : "...change message..."
      },
      "type" : "http://gedcomx.org/Residence",
      "date" : {
        "original" : "13 Apr 1836",
        "formal" : "+1836-04-13"
      },
      "place" : {
        "original" : "Moscow, Russia",
        "normalized" : [ {
          "value" : "Moskva, Moscow, Russia"
        } ]
      }
    } ],
    "display" : {
      "name" : "Anastasia Aleksandrova",
      "gender" : "Female",
      "lifespan" : "3 Apr 1836 - Dead",
      "birthDate" : "3 Apr 1836",
      "birthPlace" : "Moscow, Russia"
    }
  } ]
}

Response

HTTP/1.1 201 Created
Content-type: text/html
X-entity-id: 12345
X-processing-time: 3
Vary: Accept,Accept-Language,Accept-Encoding,Expect
Link: <https://api.familysearch.org/platform/tree/persons?flag=fsh>; rel="persons"
Link: <https://api.familysearch.org/platform/tree/persons/12345/notes?flag=fsh>; rel="notes"
Link: <https://api.familysearch.org/platform/tree/persons/12345/matches?flag=fsh>; rel="matches"
Link: <https://api.familysearch.org/platform/tree/descendancy?flag=fsh&person=12345>; rel="descendancy"
Link: <https://api.familysearch.org/platform/tree/ancestry?flag=fsh&person=12345>; rel="ancestry"
Date: Sun, 03 Apr 1836 10:00:00 GMT-5
Cache-control: no-cache, no-store, no-transform, must-revalidate, max-age=0
Location: https://api.familysearch.org/platform/tree/persons/12345
Transfer-encoding: chunked

XML

Request

POST /platform/tree/persons
Content-Type: application/x-fs-v1+xml
Authorization: Bearer YOUR_ACCESS_TOKEN_HERE<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<fs:familysearch xmlns:fs="http://familysearch.org/v1/" xmlns="http://gedcomx.org/v1/" xmlns:atom="http://www.w3.org/2005/Atom">
    <person>
        <living>false</living>
        <gender type="http://gedcomx.org/Female">
            <attribution>
                <changeMessage>...change message...</changeMessage>
            </attribution>
        </gender>
        <name type="http://gedcomx.org/BirthName">
            <attribution>
                <changeMessage>...change message...</changeMessage>
            </attribution>
            <preferred>true</preferred>
            <nameForm>
                <fullText>Anastasia Aleksandrova</fullText>
                <part type="http://gedcomx.org/Given" value="Anastasia"/>
                <part type="http://gedcomx.org/Surname" value="Aleksandrova"/>
            </nameForm>
            <nameForm>
                <fullText>Анастасия Александрова</fullText>
                <part type="http://gedcomx.org/Given" value="Анастасия"/>
                <part type="http://gedcomx.org/Surname" value="Александрова"/>
            </nameForm>
        </name>
        <fact type="http://gedcomx.org/Birth">
            <attribution>
                <changeMessage>...change message...</changeMessage>
            </attribution>
            <date>
                <original>3 Apr 1836</original>
                <formal>+1836</formal>
            </date>
            <place>
                <original>Moscow, Russia</original>
                <normalized xml:lang="en">Moscow, Moskva, Russia</normalized>
            </place>
        </fact>
        <fact type="http://gedcomx.org/Residence">
            <attribution>
                <changeMessage>...change message...</changeMessage>
            </attribution>
            <date>
                <original>13 Apr 1836</original>
                <formal>+1836-04-13</formal>
            </date>
            <place>
                <original>Moscow, Russia</original>
                <normalized>Moskva, Moscow, Russia</normalized>
            </place>
        </fact>
        <display>
            <birthDate>3 Apr 1836</birthDate>
            <birthPlace>Moscow, Russia</birthPlace>
            <gender>Female</gender>
            <lifespan>3 Apr 1836 - Dead</lifespan>
            <name>Anastasia Aleksandrova</name>
        </display>
    </person>
</fs:familysearch>

Response

HTTP/1.1 201 Created
Content-type: text/html
X-entity-id: 12345
X-processing-time: 3
Vary: Accept,Accept-Language,Accept-Encoding,Expect
Link: <https://api.familysearch.org/platform/tree/persons?flag=fsh>; rel="persons"
Link: <https://api.familysearch.org/platform/tree/persons/12345/notes?flag=fsh>; rel="notes"
Link: <https://api.familysearch.org/platform/tree/persons/12345/matches?flag=fsh>; rel="matches"
Link: <https://api.familysearch.org/platform/tree/descendancy?flag=fsh&person=12345>; rel="descendancy"
Link: <https://api.familysearch.org/platform/tree/ancestry?flag=fsh&person=12345>; rel="ancestry"
Date: Sun, 03 Apr 1836 10:00:00 GMT-5
Cache-control: no-cache, no-store, no-transform, must-revalidate, max-age=0
Location: https://api.familysearch.org/platform/tree/persons/12345
Transfer-encoding: chunked