Create Note

This example request illustrates how to create a note on a person. Notes can be used to organize specific genealogical data on a person.

JSON

Request

POST /platform/tree/persons/P12-3456/notes
Content-Type: application/x-gedcomx-v1+json
Authorization: Bearer YOUR_ACCESS_TOKEN_HERE{
  "persons" : [ {
    "id" : "P12-3456",
    "attribution" : {
      "changeMessage" : "...change message..."
    },
    "notes" : [ {
      "subject" : "Sample",
      "text" : "Sample note text",
      "attribution" : {
        "contributor" : {
          "resource" : "https://api.familysearch.org/platform/users/agents/JNYR-KJP",
          "resourceId" : "JNYR-KJP"
        }
      }
    } ]
  } ]
}

Response

HTTP/1.1 201 Created
Content-type: text/html
X-entity-id: 1
X-processing-time: 3
Vary: Accept,Accept-Language,Accept-Encoding,Expect
Content-location: /platform/tree/persons/P12-3456/notes
Date: Sun, 03 Apr 1836 10:00:00 GMT-5
Cache-control: no-transform, must-revalidate, max-age=0
Location: https://api.familysearch.org/platform/tree/persons/P12-3456/notes/1
Transfer-encoding: chunked

XML

Request

POST /platform/tree/persons/P12-3456/notes
Content-Type: application/x-gedcomx-v1+xml
Authorization: Bearer YOUR_ACCESS_TOKEN_HERE<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<gedcomx xmlns:fs="http://familysearch.org/v1/" xmlns="http://gedcomx.org/v1/" xmlns:atom="http://www.w3.org/2005/Atom">
    <person id="P12-3456">
        <attribution>
            <changeMessage>...change message...</changeMessage>
        </attribution>
        <note>
            <subject>Sample</subject>
            <text>Sample note text</text>
            <attribution>
                <contributor resource="https://api.familysearch.org/platform/users/agents/JNYR-KJP" resourceId="JNYR-KJP"/>
            </attribution>
        </note>
    </person>
</gedcomx>

Response

HTTP/1.1 201 Created
Content-type: text/html
X-entity-id: 1
X-processing-time: 3
Vary: Accept,Accept-Language,Accept-Encoding,Expect
Content-location: /platform/tree/persons/P12-3456/notes
Date: Sun, 03 Apr 1836 10:00:00 GMT-5
Cache-control: no-transform, must-revalidate, max-age=0
Location: https://api.familysearch.org/platform/tree/persons/P12-3456/notes/1
Transfer-encoding: chunked