Create a person

POST

/persons

Headers

Auth

AuthorizationstringRequired

Bearer authentication of the form Bearer <token>, where token is your auth token.

x-monite-versionstringRequired

x-monite-entity-idstringRequired

The ID of the entity that owns the requested resource.

Request

This endpoint expects an object.

first_namestringRequired>=1 character<=100 characters

The person’s first name

last_namestringRequired>=1 character<=100 characters

The person’s last name

emailstringRequired

The person’s email address

relationshipobjectRequired

Describes the person’s relationship to the entity

addressobjectOptional

The person’s address

date_of_birthstringOptional

The person’s date of birth

phonestringOptional

The person’s phone number

id_numberstringOptional>=1 character<=100 characters

The person’s ID number, as appropriate for their country

ssn_last_4stringOptional=4 characters

The last four digits of the person’s Social Security number

citizenshipenumOptional

Required for persons of US entities. The country of the person’s citizenship, as a two-letter country code (ISO 3166-1 alpha-2). In case of dual or multiple citizenship, specify any.

Response

Successful Response

idstring

The person’s unique identifier

created_atdatetime

Time at which the person was created

updated_atdatetime

Time at which the person was updated

emailstring

The person’s email address

entity_idstring

Entity ID

first_namestring

The person’s first name

last_namestring

The person’s last name

relationshipobject

Describes the person’s relationship to the entity

addressobjectOptional

The person’s address

citizenshipenumOptional

Required for persons of US entities. The country of the person’s citizenship, as a two-letter country code (ISO 3166-1 alpha-2). In case of dual or multiple citizenship, specify any.

created_by_entity_user_idstringOptional

ID of the entity user who created this person, or null if the person was created using a partner access token.

date_of_birthstringOptional

The person’s date of birth

id_numberstringOptional

The person’s ID number, as appropriate for their country

phonestringOptional

The person’s phone number

ssn_last_4stringOptional

The last four digits of the person’s Social Security number

Errors

POST

1 curl -X POST https://api.sandbox.monite.com/v1/persons \
2      -H "x-monite-version: 2024-01-31" \
3      -H "x-monite-entity-id: 9d2b4c8f-2087-4738-ba91-7359683c49a4" \
4      -H "Authorization: Bearer <token>" \
5      -H "Content-Type: application/json" \
6      -d '{
7   "first_name": "first_name",
8   "last_name": "last_name",
9   "email": "email",
10   "relationship": {}
11 }'

1 {
2   "id": "id",
3   "created_at": "2024-01-15T09:30:00Z",
4   "updated_at": "2024-01-15T09:30:00Z",
5   "email": "email",
6   "entity_id": "entity_id",
7   "first_name": "first_name",
8   "last_name": "last_name",
9   "relationship": {
10     "director": true,
11     "executive": true,
12     "owner": true,
13     "percent_ownership": 1.1,
14     "representative": true,
15     "title": "title"
16   },
17   "address": {
18     "city": "city",
19     "country": "country",
20     "line1": "line1",
21     "postal_code": "postal_code",
22     "line2": "line2",
23     "state": "state"
24   },
25   "citizenship": "AF",
26   "created_by_entity_user_id": "created_by_entity_user_id",
27   "date_of_birth": "date_of_birth",
28   "id_number": "id_number",
29   "phone": "phone",
30   "ssn_last_4": "ssn_last_4"
31 }