Apis::V4::People API

post a person that will be automatically merged

Parameters

Name Description
access_token JSON Web Token retrieved from the Sessions endpoint (you can also pass this into the Authorization header)
data The payload data that will be serialized into the new person
included List of new models to be created as related to new person.
Note on contact assignments: to specify what direction the assignment goes, the client must use either the assigned_to_id or person_id field. The omitted field will be set as the newly-created person's id. But they both will use the contact_assignment type.
fields A comma separated list of fields to return in the response for the given type. A resource object's attributes and its relationships are collectively called its 'fields'. Clients may restrict the set of fields in order to improve performance. Multiple types can be specified. If no fields param is specified then by default all fields are returned. Example

Request

Headers

Version: HTTP/1.0
Accept: application/vnd.api+json
Content-Type: application/vnd.api+json
Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoxNiwiZXhwIjoxNzA0NDczMjIzLCJpYXQiOjE3MDQ0NzMwNDN9.Mp5reiiT-3_ls3F6ZQriAiL8R1uTGMXNs0KNNt-2Vp4
Host: example.org
Cookie: 

Route

POST /apis/v4/people

Body

Response

Headers

X-Frame-Options: SAMEORIGIN
X-XSS-Protection: 1; mode=block
X-Content-Type-Options: nosniff
X-Download-Options: noopen
X-Permitted-Cross-Domain-Policies: none
Referrer-Policy: strict-origin-when-cross-origin
Content-Type: application/vnd.api+json
Vary: Accept
X-MH-Session: eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoxNiwiZXhwIjoxNzA0NjQ1ODQzLCJpYXQiOjE3MDQ0NzMwNDN9.fqlbJwKar_t3uxA3sBqhuePJik3ELv9cGuK76lk1x3g
Access-Control-Expose-Headers: X-MH-Session
ETag: W/"60319474b24b085f8a6ec28d12b50733"
Cache-Control: max-age=0, private, must-revalidate
X-Request-Id: a8e221e3-d5e3-4c17-853a-2b5f252f9cf4
X-Runtime: 0.142375
Content-Length: 1635

Status

200

Body