The Persons resource provides the interface to create a person, including the name, gender or facts of the person.

Data Formats

If you make a GET request, specify the data format using the Accept header.

If you POST something, specify the media type using the Content-Type header.


Name Type Description
X-Reason header Header giving the reason for creating a person.
Authorization header The authorization carrying the OAuth 2.0 access token. See OAuth 2.0 Bearer Tokens.
skipDateNormalization query When the parameter is true, then normalized dates remain blank even when the original value is filled in. (By default the original will be normalized automatically if the normalized value is blank).
access_token query The ID of the OAuth 2 access token used for identification and authorization of the user (and agent) making the request.


POST - Create a person.

Status Codes
201 The creation of the person was successful. Expect a location header specifying the link to the created person.
429 If the request was throttled.

Example Requests

Create Person How to create a person.