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"
          }
        }
      ]
    }
  ]
}