Create Tree Person Reference
This example request illustrates how to add a Tree Person Reference to a person.
JSON
Request
POST /platform/tree/persons/BSSY-L55 HTTP/1.1
Accept: application/json
Content-Type: application/x-fs-v1+json
Authorization: Bearer YOUR_ACCESS_TOKEN_HERE
Host: apibeta.familysearch.org
Content-Length: 195
{
"persons": [
{
"id": "BSSY-L55",
"tree-person-references": [
{
"treePerson": {
"resourceId": "KWCH-DGR"
}
}
]
}
]
}Response
HTTP/1.1 200
date: Wed, 23 Jul 2025 22:31:24 GMT
content-type: application/json
cache-control: max-age=0, must-revalidate, no-transform
content-location: /tree/persons/BSSY-L55
server: nginx
vary: accept,accept-language,accept-encoding,expect
x-processing-time: 266
x-robots-tag: noindex, nofollow, noarchive, nosnippet, notranslate, noimageindex
{
"persons": [
{
"id": "BSSY-L55",
"links": {
"spouses": {
"href": "https://apibeta.familysearch.org/platform/tree/persons/BSSY-L55/spouses?flag=fsh"
},
"change-history": {
"href": "https://apibeta.familysearch.org/platform/tree/persons/BSSY-L55/changes?flag=fsh"
},
"ancestry": {
"href": "https://apibeta.familysearch.org/platform/tree/ancestry?flag=fsh&person=BSSY-L55"
},
"notes": {
"href": "https://apibeta.familysearch.org/platform/tree/persons/BSSY-L55/notes?flag=fsh"
},
"non-matches": {
"href": "https://apibeta.familysearch.org/platform/tree/persons/BSSY-L55/not-a-match?flag=fsh"
},
"portraits": {
"href": "https://apibeta.familysearch.org/platform/tree/persons/BSSY-L55/portraits?flag=fsh"
},
"collection": {
"href": "https://apibeta.familysearch.org/platform/collections/tree?flag=fsh"
},
"families": {
"href": "https://apibeta.familysearch.org/platform/tree/persons/BSSY-L55/families?flag=fsh"
},
"portrait": {
"href": "https://apibeta.familysearch.org/platform/tree/persons/BSSY-L55/portrait?flag=fsh"
},
"matches": {
"href": "https://apibeta.familysearch.org/platform/tree/persons/BSSY-L55/matches?flag=fsh"
},
"children": {
"href": "https://apibeta.familysearch.org/platform/tree/persons/BSSY-L55/children?flag=fsh"
},
"descendancy": {
"href": "https://apibeta.familysearch.org/platform/tree/descendancy?flag=fsh&person=BSSY-L55"
},
"person": {
"href": "https://apibeta.familysearch.org/platform/tree/persons/BSSY-L55?flag=fsh"
},
"source-descriptions": {
"href": "https://apibeta.familysearch.org/platform/tree/persons/BSSY-L55/sources?flag=fsh"
},
"merge": {
"template": "https://apibeta.familysearch.org/platform/tree/persons/{pid}/merges/{dpid}?flag=fst{&filter,access_token}",
"type": "application/json,application/x-fs-v1+json,application/x-fs-v1+xml,application/xml,text/html",
"accept": "*/*",
"allow": "GET,OPTIONS,POST",
"title": "Person Merge"
},
"artifacts": {
"href": "https://apibeta.familysearch.org/platform/tree/persons/BSSY-L55/memories?flag=fsh"
},
"parents": {
"href": "https://apibeta.familysearch.org/platform/tree/persons/BSSY-L55/parents?flag=fsh"
}
},
"tree-person-references": [
{
"id": "55a832be-5f0d-4a9c-a26a-f33d61a5bb1c",
"treePerson": {
"resourceId": "KWCH-DGR"
}
}
]
}
]
}XML
Request
POST /platform/tree/persons/BSSY-L55 HTTP/1.1
Accept: application/x-gedcomx-v1+xml
Content-Type: application/x-gedcomx-v1+xml
Authorization: Bearer YOUR_ACCESS_TOKEN_HERE
Host: apibeta.familysearch.org
Content-Length: 398
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<ns3:familysearch xmlns:ns2="http://familysearch.org/platform/artifacts" xmlns:ns3="http://familysearch.org/v1/" xmlns:ns4="http://gedcomx.org/v1/">
<ns4:person id="BSSY-L55">
<ns3:tree-person-reference>
<ns3:treePerson resourceId="BM3Y-VZP"/>
</ns3:tree-person-reference>
</ns4:person>
</ns3:familysearch>Response
HTTP/1.1 200
date: Thu, 14 Aug 2025 03:15:47 GMT
content-type: application/x-gedcomx-v1+xml
transfer-encoding: chunked
connection: keep-alive
cache-control: max-age=0, must-revalidate, no-transform
content-location: /tree/persons/BSSY-L55
server: nginx
vary: accept,accept-language,accept-encoding,expect
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<ns4:gedcomx xmlns:ns2="http://familysearch.org/platform/artifacts" xmlns:ns3="http://familysearch.org/v1/" xmlns:ns4="http://gedcomx.org/v1/" xmlns:ns5="http://www.w3.org/2005/Atom">
<ns4:person id="BSSY-L55">
<ns3:tree-person-reference id="71c07840-a4cf-48a9-a48d-f88abaa4f94f">
<ns3:treePerson resourceId="BM3Y-VZP"/>
</ns3:tree-person-reference>
<ns4:link rel="ancestry" href="https://apibeta.familysearch.org/platform/tree/ancestry?flag=fsh&person=BSSY-L55"/>
<ns4:link rel="artifacts" href="https://apibeta.familysearch.org/platform/tree/persons/BSSY-L55/memories?flag=fsh"/>
<ns4:link rel="change-history" href="https://apibeta.familysearch.org/platform/tree/persons/BSSY-L55/changes?flag=fsh"/>
<ns4:link rel="children" href="https://apibeta.familysearch.org/platform/tree/persons/BSSY-L55/children?flag=fsh"/>
<ns4:link rel="collection" href="https://apibeta.familysearch.org/platform/collections/tree?flag=fsh"/>
<ns4:link rel="descendancy" href="https://apibeta.familysearch.org/platform/tree/descendancy?flag=fsh&person=BSSY-L55"/>
<ns4:link rel="families" href="https://apibeta.familysearch.org/platform/tree/persons/BSSY-L55/families?flag=fsh"/>
<ns4:link rel="matches" href="https://apibeta.familysearch.org/platform/tree/persons/BSSY-L55/matches?flag=fsh"/>
<ns4:link rel="merge" template="https://apibeta.familysearch.org/platform/tree/persons/{pid}/merges/{dpid}?flag=fst{&filter,access_token}" title="Person Merge" type="application/json,application/x-fs-v1+json,application/x-fs-v1+xml,application/xml,text/html" accept="*/*" allow="GET,OPTIONS,POST"/>
<ns4:link rel="non-matches" href="https://apibeta.familysearch.org/platform/tree/persons/BSSY-L55/not-a-match?flag=fsh"/>
<ns4:link rel="notes" href="https://apibeta.familysearch.org/platform/tree/persons/BSSY-L55/notes?flag=fsh"/>
<ns4:link rel="parents" href="https://apibeta.familysearch.org/platform/tree/persons/BSSY-L55/parents?flag=fsh"/>
<ns4:link rel="person" href="https://apibeta.familysearch.org/platform/tree/persons/BSSY-L55?flag=fsh"/>
<ns4:link rel="portrait" href="https://apibeta.familysearch.org/platform/tree/persons/BSSY-L55/portrait?flag=fsh"/>
<ns4:link rel="portraits" href="https://apibeta.familysearch.org/platform/tree/persons/BSSY-L55/portraits?flag=fsh"/>
<ns4:link rel="source-descriptions" href="https://apibeta.familysearch.org/platform/tree/persons/BSSY-L55/sources?flag=fsh"/>
<ns4:link rel="spouses" href="https://apibeta.familysearch.org/platform/tree/persons/BSSY-L55/spouses?flag=fsh"/>
</ns4:person>
</ns4:gedcomx>Updated 25 days ago