API Documentation
People ¶
People ¶
For more details on how to work with custom fields please refer to Working with custom fields guide.
Supported filter params
-
id
-
email
-
status (1: active, 2: deactivated)
-
person_type (1: user, 2: contact, 3: placeholder)
-
role_id (array)
-
company_id (array)
-
tags
-
query
-
subscribable_type (task, deal, person, company, invoice, page)
-
subscribable_id (array)
-
custom_fields[id] (where id is the identifier of your custom field; for dropdown and multiselect custom fields, use array filter)
-
last_activity_at
-
two_factor_auth
-
team
-
autotracking
-
custom_role_id
-
manager_id
-
project_id
-
timesheet_submission_disabled (boolean)
-
time_tracking_policy_id
-
service_type_id
Supported sort params
-
name
-
email
-
title
-
last_seen_at
-
joined_at
-
role_id
-
autotracking
-
company_name
-
custom_role
-
custom_fields
-
two_factor_auth
-
schedulable
-
manager
Filter operations are supported on this endpoint.
PATCH /api/v2/people/3387/invite
Headers
Accept: text/xml,application/xml,application/xhtml+xml,text/html;q=0.9,text/plain;q=0.8,image/png,*/*;q=0.5
Content-Type: application/vnd.api+jsonBody
{
"data": {
"type": "people",
"attributes": {},
"relationships": {
"company": {
"data": {
"type": "companies",
"id": "2478"
}
},
"subsidiary": {
"data": {
"type": "subsidiaries",
"id": "1053"
}
},
"custom_role": {
"data": {
"type": "custom_roles",
"id": "3331"
}
}
}
}
}Headers
Content-Type: application/vnd.api+json; charset=utf-8Body
{
"data": {
"id": "3387",
"type": "people",
"attributes": {
"agent": false,
"avatar_url": null,
"contact": {},
"deactivated_at": null,
"email": "person2444@email.com",
"first_name": "name",
"last_name": "surname",
"nickname": null,
"original_avatar_url": null,
"role_id": 1,
"status_emoji": null,
"status_expires_at": null,
"status_text": null,
"time_off_status_sync": true,
"title": null,
"archived_at": null,
"autotracking": false,
"joined_at": null,
"last_seen_at": null,
"invited_at": "2026-04-01T06:07:47.000+02:00",
"is_user": true,
"user_id": 3396,
"tag_list": [],
"virtual": false,
"custom_fields": null,
"created_at": "2026-04-01T06:07:47.792+02:00",
"placeholder": false,
"color_id": null,
"sample_data": false,
"time_unlocked": false,
"time_unlocked_on": null,
"time_unlocked_start_date": null,
"time_unlocked_end_date": null,
"time_unlocked_period_id": null,
"time_unlocked_interval": null,
"last_activity_at": "2026-04-01T06:07:47.792+02:00",
"two_factor_auth": false,
"availabilities": "[]",
"external_id": null,
"external_sync": false,
"hrm_type_id": 1,
"champion": false,
"timesheet_submission_disabled": false,
"offboarding_status": "not_initiated",
"offboarding_id": null,
"time_tracking_policy_id": null
},
"relationships": {
"organization": {
"data": {
"type": "organizations",
"id": "911"
}
},
"company": {
"meta": {
"included": false
}
},
"custom_role": {
"meta": {
"included": false
}
},
"manager": {
"meta": {
"included": false
}
},
"subsidiary": {
"meta": {
"included": false
}
},
"approval_policy_assignment": {
"meta": {
"included": false
}
},
"teams": {
"meta": {
"included": false
}
},
"service_types": {
"meta": {
"included": false
}
},
"custom_field_people": {
"meta": {
"included": false
}
},
"custom_field_attachments": {
"meta": {
"included": false
}
}
}
},
"meta": {}
}PATCH /api/v2/people/3391/invite
Headers
Accept: text/xml,application/xml,application/xhtml+xml,text/html;q=0.9,text/plain;q=0.8,image/png,*/*;q=0.5
Content-Type: application/vnd.api+jsonBody
{
"data": {
"type": "people",
"attributes": {
"custom_role_id": 0
}
}
}Headers
Content-Type: application/vnd.api+json; charset=utf-8Body
{
"errors": [
{
"status": "422",
"code": "invalid_attribute",
"title": "Invalid Attribute",
"detail": "can't be blank",
"meta": {},
"source": {
"pointer": "data/attributes/company"
}
},
{
"status": "422",
"code": "custom_role_not_accessible",
"title": "Invalid Attribute",
"detail": "is not accessible",
"meta": {},
"source": {
"pointer": "data/attributes/custom_role"
}
}
]
}Invite a personPATCH/api/v2/people/invite
Action used to invite contacts into your Productive organization. By doing so, the contact can accept that invitation and then become a user.
- company_id
number(required) Example: 1company id
- custom_role_id
number(required) Example: 1role id
- subsidiary_id
number(optional) Example: 1subsidiary id
GET /api/v2/people
Headers
Accept: text/xml,application/xml,application/xhtml+xml,text/html;q=0.9,text/plain;q=0.8,image/png,*/*;q=0.5
Content-Type: application/vnd.api+jsonHeaders
Content-Type: application/vnd.api+json; charset=utf-8Body
{
"data": [
{
"id": "3392",
"type": "people",
"attributes": {
"agent": false,
"avatar_url": null,
"contact": {},
"deactivated_at": null,
"email": "user3350@email.com",
"first_name": "name",
"last_name": "surname",
"nickname": null,
"original_avatar_url": null,
"role_id": 1,
"status_emoji": null,
"status_expires_at": null,
"status_text": null,
"time_off_status_sync": true,
"title": null,
"archived_at": null,
"autotracking": false,
"joined_at": null,
"last_seen_at": null,
"invited_at": null,
"is_user": true,
"user_id": 3400,
"tag_list": [],
"virtual": false,
"custom_fields": null,
"created_at": "2026-04-01T06:07:48.008+02:00",
"placeholder": false,
"color_id": null,
"sample_data": false,
"time_unlocked": false,
"time_unlocked_on": null,
"time_unlocked_start_date": null,
"time_unlocked_end_date": null,
"time_unlocked_period_id": null,
"time_unlocked_interval": null,
"last_activity_at": null,
"two_factor_auth": false,
"availabilities": "[]",
"external_id": null,
"external_sync": false,
"hrm_type_id": 1,
"champion": false,
"timesheet_submission_disabled": false,
"offboarding_status": "not_initiated",
"offboarding_id": null,
"time_tracking_policy_id": null
},
"relationships": {
"organization": {
"data": {
"type": "organizations",
"id": "914"
}
},
"company": {
"meta": {
"included": false
}
},
"custom_role": {
"meta": {
"included": false
}
},
"manager": {
"meta": {
"included": false
}
},
"subsidiary": {
"meta": {
"included": false
}
},
"approval_policy_assignment": {
"meta": {
"included": false
}
},
"teams": {
"meta": {
"included": false
}
},
"service_types": {
"meta": {
"included": false
}
},
"custom_field_people": {
"meta": {
"included": false
}
},
"custom_field_attachments": {
"meta": {
"included": false
}
}
}
}
],
"links": {
"first": "http://api-test.productive.io/api/v2/people?page%5Bnumber%5D=1&page%5Bsize%5D=30",
"last": "http://api-test.productive.io/api/v2/people?page%5Bnumber%5D=1&page%5Bsize%5D=30"
},
"meta": {
"current_page": 1,
"total_pages": 1,
"total_count": 1,
"page_size": 30,
"max_page_size": 200
}
}Get peopleGET/api/v2/people
GET /api/v2/people/3395
Headers
Accept: text/xml,application/xml,application/xhtml+xml,text/html;q=0.9,text/plain;q=0.8,image/png,*/*;q=0.5
Content-Type: application/vnd.api+jsonHeaders
Content-Type: application/vnd.api+json; charset=utf-8Body
{
"data": {
"id": "3395",
"type": "people",
"attributes": {
"agent": false,
"avatar_url": null,
"contact": {},
"deactivated_at": null,
"email": "person2447@email.com",
"first_name": "name",
"last_name": "surname",
"nickname": null,
"original_avatar_url": null,
"role_id": null,
"status_emoji": null,
"status_expires_at": null,
"status_text": null,
"time_off_status_sync": true,
"title": null,
"archived_at": null,
"autotracking": false,
"joined_at": null,
"last_seen_at": null,
"invited_at": null,
"is_user": false,
"user_id": null,
"tag_list": [],
"virtual": false,
"custom_fields": null,
"created_at": "2026-04-01T06:07:48.192+02:00",
"placeholder": false,
"color_id": null,
"sample_data": false,
"time_unlocked": false,
"time_unlocked_on": null,
"time_unlocked_start_date": null,
"time_unlocked_end_date": null,
"time_unlocked_period_id": null,
"time_unlocked_interval": null,
"last_activity_at": "2026-04-01T06:07:48.192+02:00",
"two_factor_auth": null,
"availabilities": "[]",
"external_id": null,
"external_sync": false,
"hrm_type_id": 2,
"champion": false,
"timesheet_submission_disabled": false,
"offboarding_status": "not_initiated",
"offboarding_id": null,
"time_tracking_policy_id": null
},
"relationships": {
"organization": {
"data": {
"type": "organizations",
"id": "916"
}
},
"company": {
"meta": {
"included": false
}
},
"custom_role": {
"meta": {
"included": false
}
},
"manager": {
"meta": {
"included": false
}
},
"subsidiary": {
"meta": {
"included": false
}
},
"approval_policy_assignment": {
"meta": {
"included": false
}
},
"teams": {
"meta": {
"included": false
}
},
"service_types": {
"meta": {
"included": false
}
},
"custom_field_people": {
"meta": {
"included": false
}
},
"custom_field_attachments": {
"meta": {
"included": false
}
}
}
},
"meta": {}
}POST /api/v2/people
Headers
Accept: text/xml,application/xml,application/xhtml+xml,text/html;q=0.9,text/plain;q=0.8,image/png,*/*;q=0.5
Content-Type: application/vnd.api+jsonBody
{
"data": {
"type": "people",
"attributes": {
"first_name": "test name"
}
}
}Headers
Content-Type: application/vnd.api+json; charset=utf-8Body
{
"data": {
"id": "3398",
"type": "people",
"attributes": {
"agent": false,
"avatar_url": null,
"contact": null,
"deactivated_at": null,
"email": null,
"first_name": "test name",
"last_name": null,
"nickname": null,
"original_avatar_url": null,
"role_id": null,
"status_emoji": null,
"status_expires_at": null,
"status_text": null,
"time_off_status_sync": true,
"title": null,
"archived_at": null,
"autotracking": false,
"joined_at": null,
"last_seen_at": null,
"invited_at": null,
"is_user": false,
"user_id": null,
"tag_list": [],
"virtual": false,
"custom_fields": null,
"created_at": "2026-04-01T06:07:48.342+02:00",
"placeholder": false,
"color_id": null,
"sample_data": false,
"time_unlocked": false,
"time_unlocked_on": null,
"time_unlocked_start_date": null,
"time_unlocked_end_date": null,
"time_unlocked_period_id": null,
"time_unlocked_interval": null,
"last_activity_at": "2026-04-01T06:07:48.342+02:00",
"two_factor_auth": null,
"availabilities": "[]",
"external_id": null,
"external_sync": false,
"hrm_type_id": 2,
"champion": false,
"timesheet_submission_disabled": false,
"offboarding_status": "not_initiated",
"offboarding_id": null,
"time_tracking_policy_id": null
},
"relationships": {
"organization": {
"data": {
"type": "organizations",
"id": "918"
}
},
"company": {
"meta": {
"included": false
}
},
"custom_role": {
"meta": {
"included": false
}
},
"manager": {
"meta": {
"included": false
}
},
"subsidiary": {
"meta": {
"included": false
}
},
"approval_policy_assignment": {
"meta": {
"included": false
}
},
"teams": {
"meta": {
"included": false
}
},
"service_types": {
"meta": {
"included": false
}
},
"custom_field_people": {
"meta": {
"included": false
}
},
"custom_field_attachments": {
"meta": {
"included": false
}
}
}
},
"meta": {}
}POST /api/v2/people
Headers
Accept: text/xml,application/xml,application/xhtml+xml,text/html;q=0.9,text/plain;q=0.8,image/png,*/*;q=0.5
Content-Type: application/vnd.api+jsonBody
{
"data": {
"type": "people",
"attributes": {
"first_name": ""
}
}
}Headers
Content-Type: application/vnd.api+json; charset=utf-8Body
{
"errors": [
{
"status": "422",
"code": "invalid_attribute",
"title": "Invalid Attribute",
"detail": "can't be blank",
"meta": {},
"source": {
"pointer": "data/attributes/first_name"
}
}
]
}Create a personPOST/api/v2/people
- first_name: `John` (string, required) - first_name
string(required)
PATCH /api/v2/people/3404
Headers
Accept: text/xml,application/xml,application/xhtml+xml,text/html;q=0.9,text/plain;q=0.8,image/png,*/*;q=0.5
Content-Type: application/vnd.api+jsonBody
{
"data": {
"type": "people",
"attributes": {
"first_name": "new name"
},
"relationships": {
"subscribers": {
"data": [
{
"type": "people",
"id": "3405"
},
{
"type": "people",
"id": "3406"
}
]
}
}
}
}Headers
Content-Type: application/vnd.api+json; charset=utf-8Body
{
"data": {
"id": "3404",
"type": "people",
"attributes": {
"agent": false,
"avatar_url": null,
"contact": {},
"deactivated_at": null,
"email": "person2448@email.com",
"first_name": "new name",
"last_name": "surname",
"nickname": null,
"original_avatar_url": null,
"role_id": null,
"status_emoji": null,
"status_expires_at": null,
"status_text": null,
"time_off_status_sync": true,
"title": null,
"archived_at": null,
"autotracking": false,
"joined_at": null,
"last_seen_at": null,
"invited_at": null,
"is_user": false,
"user_id": null,
"tag_list": [],
"virtual": false,
"custom_fields": null,
"created_at": "2026-04-01T06:07:48.572+02:00",
"placeholder": false,
"color_id": null,
"sample_data": false,
"time_unlocked": false,
"time_unlocked_on": null,
"time_unlocked_start_date": null,
"time_unlocked_end_date": null,
"time_unlocked_period_id": null,
"time_unlocked_interval": null,
"last_activity_at": "2026-04-01T06:07:48.572+02:00",
"two_factor_auth": null,
"availabilities": "[]",
"external_id": null,
"external_sync": false,
"hrm_type_id": 2,
"champion": false,
"timesheet_submission_disabled": false,
"offboarding_status": "not_initiated",
"offboarding_id": null,
"time_tracking_policy_id": null
},
"relationships": {
"organization": {
"data": {
"type": "organizations",
"id": "922"
}
},
"company": {
"meta": {
"included": false
}
},
"custom_role": {
"meta": {
"included": false
}
},
"manager": {
"meta": {
"included": false
}
},
"subsidiary": {
"meta": {
"included": false
}
},
"approval_policy_assignment": {
"meta": {
"included": false
}
},
"teams": {
"meta": {
"included": false
}
},
"service_types": {
"meta": {
"included": false
}
},
"custom_field_people": {
"meta": {
"included": false
}
},
"custom_field_attachments": {
"meta": {
"included": false
}
}
}
},
"meta": {}
}PATCH /api/v2/people/3412
Headers
Accept: text/xml,application/xml,application/xhtml+xml,text/html;q=0.9,text/plain;q=0.8,image/png,*/*;q=0.5
Content-Type: application/vnd.api+jsonBody
{
"data": {
"type": "people",
"attributes": {
"first_name": ""
}
}
}Headers
Content-Type: application/vnd.api+json; charset=utf-8Body
{
"errors": [
{
"status": "422",
"code": "invalid_attribute",
"title": "Invalid Attribute",
"detail": "can't be blank",
"meta": {},
"source": {
"pointer": "data/attributes/first_name"
}
}
]
}PATCH /api/v2/people/3528/resend
Headers
Accept: text/xml,application/xml,application/xhtml+xml,text/html;q=0.9,text/plain;q=0.8,image/png,*/*;q=0.5
Content-Type: application/vnd.api+jsonHeaders
Content-Type: application/vnd.api+json; charset=utf-8Body
{
"data": {
"id": "3528",
"type": "people",
"attributes": {
"agent": false,
"avatar_url": null,
"contact": {},
"deactivated_at": null,
"email": "user3474@email.com",
"first_name": "name",
"last_name": "surname",
"nickname": null,
"original_avatar_url": null,
"role_id": 3,
"status_emoji": null,
"status_expires_at": null,
"status_text": null,
"time_off_status_sync": true,
"title": null,
"archived_at": null,
"autotracking": false,
"joined_at": null,
"last_seen_at": null,
"invited_at": "2026-04-01T06:07:54.000+02:00",
"is_user": true,
"user_id": 3524,
"tag_list": [],
"virtual": false,
"custom_fields": null,
"created_at": "2026-04-01T06:07:54.941+02:00",
"placeholder": false,
"color_id": null,
"sample_data": false,
"time_unlocked": false,
"time_unlocked_on": null,
"time_unlocked_start_date": null,
"time_unlocked_end_date": null,
"time_unlocked_period_id": null,
"time_unlocked_interval": null,
"last_activity_at": "2026-04-01T06:07:54.941+02:00",
"two_factor_auth": false,
"availabilities": "[]",
"external_id": null,
"external_sync": false,
"hrm_type_id": 1,
"champion": false,
"timesheet_submission_disabled": false,
"offboarding_status": "not_initiated",
"offboarding_id": null,
"time_tracking_policy_id": null
},
"relationships": {
"organization": {
"data": {
"type": "organizations",
"id": "979"
}
},
"company": {
"meta": {
"included": false
}
},
"custom_role": {
"meta": {
"included": false
}
},
"manager": {
"meta": {
"included": false
}
},
"subsidiary": {
"meta": {
"included": false
}
},
"approval_policy_assignment": {
"meta": {
"included": false
}
},
"teams": {
"meta": {
"included": false
}
},
"service_types": {
"meta": {
"included": false
}
},
"custom_field_people": {
"meta": {
"included": false
}
},
"custom_field_attachments": {
"meta": {
"included": false
}
}
}
},
"meta": {}
}Resend email to a personPATCH/api/v2/people/{id}/resend
- id
number(required) Example: 1person id
PATCH /api/v2/people/3532/deactivate
Headers
Accept: text/xml,application/xml,application/xhtml+xml,text/html;q=0.9,text/plain;q=0.8,image/png,*/*;q=0.5
Content-Type: application/vnd.api+jsonHeaders
Content-Type: application/vnd.api+json; charset=utf-8Body
{
"data": {
"id": "3532",
"type": "people",
"attributes": {
"agent": false,
"avatar_url": null,
"contact": {},
"deactivated_at": "2026-04-01T06:07:55.000+02:00",
"email": "user3478@email.com",
"first_name": "name",
"last_name": "surname",
"nickname": null,
"original_avatar_url": null,
"role_id": 3,
"status_emoji": null,
"status_expires_at": null,
"status_text": null,
"time_off_status_sync": true,
"title": null,
"archived_at": null,
"autotracking": false,
"joined_at": null,
"last_seen_at": null,
"invited_at": "2026-04-01T06:07:00.000+02:00",
"is_user": true,
"user_id": 3528,
"tag_list": [],
"virtual": false,
"custom_fields": null,
"created_at": "2026-04-01T06:07:55.088+02:00",
"placeholder": false,
"color_id": null,
"sample_data": false,
"time_unlocked": false,
"time_unlocked_on": null,
"time_unlocked_start_date": null,
"time_unlocked_end_date": null,
"time_unlocked_period_id": null,
"time_unlocked_interval": null,
"last_activity_at": "2026-04-01T06:07:55.088+02:00",
"two_factor_auth": false,
"availabilities": "[]",
"external_id": null,
"external_sync": false,
"hrm_type_id": 1,
"champion": false,
"timesheet_submission_disabled": false,
"offboarding_status": "not_initiated",
"offboarding_id": null,
"time_tracking_policy_id": null
},
"relationships": {
"organization": {
"data": {
"type": "organizations",
"id": "981"
}
},
"company": {
"meta": {
"included": false
}
},
"custom_role": {
"meta": {
"included": false
}
},
"manager": {
"meta": {
"included": false
}
},
"subsidiary": {
"meta": {
"included": false
}
},
"approval_policy_assignment": {
"meta": {
"included": false
}
},
"teams": {
"meta": {
"included": false
}
},
"service_types": {
"meta": {
"included": false
}
},
"custom_field_people": {
"meta": {
"included": false
}
},
"custom_field_attachments": {
"meta": {
"included": false
}
}
}
},
"meta": {}
}Deactivate a personPATCH/api/v2/people/{id}/deactivate
- id
number(required) Example: 1person id
PATCH /api/v2/people/3540/activate
Headers
Accept: text/xml,application/xml,application/xhtml+xml,text/html;q=0.9,text/plain;q=0.8,image/png,*/*;q=0.5
Content-Type: application/vnd.api+jsonHeaders
Content-Type: application/vnd.api+json; charset=utf-8Body
{
"data": {
"id": "3540",
"type": "people",
"attributes": {
"agent": false,
"avatar_url": null,
"contact": {},
"deactivated_at": null,
"email": "user3485@email.com",
"first_name": "name",
"last_name": "surname",
"nickname": null,
"original_avatar_url": null,
"role_id": 3,
"status_emoji": null,
"status_expires_at": null,
"status_text": null,
"time_off_status_sync": true,
"title": null,
"archived_at": null,
"autotracking": false,
"joined_at": null,
"last_seen_at": null,
"invited_at": "2026-04-01T06:07:00.000+02:00",
"is_user": true,
"user_id": 3535,
"tag_list": [],
"virtual": false,
"custom_fields": null,
"created_at": "2026-04-01T06:07:55.368+02:00",
"placeholder": false,
"color_id": null,
"sample_data": false,
"time_unlocked": false,
"time_unlocked_on": null,
"time_unlocked_start_date": null,
"time_unlocked_end_date": null,
"time_unlocked_period_id": null,
"time_unlocked_interval": null,
"last_activity_at": "2026-04-01T06:07:55.368+02:00",
"two_factor_auth": false,
"availabilities": "[]",
"external_id": null,
"external_sync": false,
"hrm_type_id": 1,
"champion": false,
"timesheet_submission_disabled": false,
"offboarding_status": "not_initiated",
"offboarding_id": null,
"time_tracking_policy_id": null
},
"relationships": {
"organization": {
"data": {
"type": "organizations",
"id": "985"
}
},
"company": {
"meta": {
"included": false
}
},
"custom_role": {
"meta": {
"included": false
}
},
"manager": {
"meta": {
"included": false
}
},
"subsidiary": {
"meta": {
"included": false
}
},
"approval_policy_assignment": {
"meta": {
"included": false
}
},
"teams": {
"meta": {
"included": false
}
},
"service_types": {
"meta": {
"included": false
}
},
"custom_field_people": {
"meta": {
"included": false
}
},
"custom_field_attachments": {
"meta": {
"included": false
}
}
}
},
"meta": {}
}PATCH /api/v2/people/3544/activate
Headers
Accept: text/xml,application/xml,application/xhtml+xml,text/html;q=0.9,text/plain;q=0.8,image/png,*/*;q=0.5
Content-Type: application/vnd.api+jsonHeaders
Content-Type: application/vnd.api+json; charset=utf-8Body
{
"data": {
"id": "3544",
"type": "people",
"attributes": {
"agent": false,
"avatar_url": null,
"contact": {},
"deactivated_at": null,
"email": "user3488@email.com",
"first_name": "name",
"last_name": "surname",
"nickname": null,
"original_avatar_url": null,
"role_id": 3,
"status_emoji": null,
"status_expires_at": null,
"status_text": null,
"time_off_status_sync": true,
"title": null,
"archived_at": null,
"autotracking": false,
"joined_at": null,
"last_seen_at": null,
"invited_at": "2026-04-01T06:07:00.000+02:00",
"is_user": true,
"user_id": 3538,
"tag_list": [],
"virtual": false,
"custom_fields": null,
"created_at": "2026-04-01T06:07:55.514+02:00",
"placeholder": false,
"color_id": null,
"sample_data": false,
"time_unlocked": false,
"time_unlocked_on": null,
"time_unlocked_start_date": null,
"time_unlocked_end_date": null,
"time_unlocked_period_id": null,
"time_unlocked_interval": null,
"last_activity_at": "2026-04-01T06:07:55.514+02:00",
"two_factor_auth": false,
"availabilities": "[]",
"external_id": null,
"external_sync": false,
"hrm_type_id": 1,
"champion": false,
"timesheet_submission_disabled": false,
"offboarding_status": "not_initiated",
"offboarding_id": null,
"time_tracking_policy_id": null
},
"relationships": {
"organization": {
"data": {
"type": "organizations",
"id": "987"
}
},
"company": {
"meta": {
"included": false
}
},
"custom_role": {
"meta": {
"included": false
}
},
"manager": {
"meta": {
"included": false
}
},
"subsidiary": {
"meta": {
"included": false
}
},
"approval_policy_assignment": {
"meta": {
"included": false
}
},
"teams": {
"meta": {
"included": false
}
},
"service_types": {
"meta": {
"included": false
}
},
"custom_field_people": {
"meta": {
"included": false
}
},
"custom_field_attachments": {
"meta": {
"included": false
}
}
}
},
"meta": {}
}Activate a personPATCH/api/v2/people/{id}/activate
- id
number(required) Example: 1person id
PATCH /api/v2/people/3565/archive
Headers
Accept: text/xml,application/xml,application/xhtml+xml,text/html;q=0.9,text/plain;q=0.8,image/png,*/*;q=0.5
Content-Type: application/vnd.api+jsonHeaders
Content-Type: application/vnd.api+json; charset=utf-8Body
{
"data": {
"id": "3565",
"type": "people",
"attributes": {
"agent": false,
"avatar_url": null,
"contact": {},
"deactivated_at": null,
"email": "person2537@email.com",
"first_name": "name",
"last_name": "surname",
"nickname": null,
"original_avatar_url": null,
"role_id": null,
"status_emoji": null,
"status_expires_at": null,
"status_text": null,
"time_off_status_sync": true,
"title": null,
"archived_at": "2026-04-01T06:07:56.000+02:00",
"autotracking": false,
"joined_at": null,
"last_seen_at": null,
"invited_at": null,
"is_user": false,
"user_id": null,
"tag_list": [],
"virtual": false,
"custom_fields": null,
"created_at": "2026-04-01T06:07:56.511+02:00",
"placeholder": false,
"color_id": null,
"sample_data": false,
"time_unlocked": false,
"time_unlocked_on": null,
"time_unlocked_start_date": null,
"time_unlocked_end_date": null,
"time_unlocked_period_id": null,
"time_unlocked_interval": null,
"last_activity_at": "2026-04-01T06:07:56.511+02:00",
"two_factor_auth": null,
"availabilities": "[]",
"external_id": null,
"external_sync": false,
"hrm_type_id": 2,
"champion": false,
"timesheet_submission_disabled": false,
"offboarding_status": "not_initiated",
"offboarding_id": null,
"time_tracking_policy_id": null
},
"relationships": {
"organization": {
"data": {
"type": "organizations",
"id": "996"
}
},
"company": {
"meta": {
"included": false
}
},
"custom_role": {
"meta": {
"included": false
}
},
"manager": {
"meta": {
"included": false
}
},
"subsidiary": {
"meta": {
"included": false
}
},
"approval_policy_assignment": {
"meta": {
"included": false
}
},
"teams": {
"meta": {
"included": false
}
},
"service_types": {
"meta": {
"included": false
}
},
"custom_field_people": {
"meta": {
"included": false
}
},
"custom_field_attachments": {
"meta": {
"included": false
}
}
}
},
"meta": {}
}PATCH /api/v2/people/3569/archive
Headers
Accept: text/xml,application/xml,application/xhtml+xml,text/html;q=0.9,text/plain;q=0.8,image/png,*/*;q=0.5
Content-Type: application/vnd.api+jsonHeaders
Content-Type: application/vnd.api+json; charset=utf-8Body
{
"data": {
"id": "3569",
"type": "people",
"attributes": {
"agent": false,
"avatar_url": null,
"contact": {},
"deactivated_at": null,
"email": "person2539@email.com",
"first_name": "name",
"last_name": "surname",
"nickname": null,
"original_avatar_url": null,
"role_id": null,
"status_emoji": null,
"status_expires_at": null,
"status_text": null,
"time_off_status_sync": true,
"title": null,
"archived_at": "2026-04-01T06:07:56.000+02:00",
"autotracking": false,
"joined_at": null,
"last_seen_at": null,
"invited_at": null,
"is_user": false,
"user_id": null,
"tag_list": [],
"virtual": false,
"custom_fields": null,
"created_at": "2026-04-01T06:07:56.635+02:00",
"placeholder": true,
"color_id": null,
"sample_data": false,
"time_unlocked": false,
"time_unlocked_on": null,
"time_unlocked_start_date": null,
"time_unlocked_end_date": null,
"time_unlocked_period_id": null,
"time_unlocked_interval": null,
"last_activity_at": "2026-04-01T06:07:56.635+02:00",
"two_factor_auth": null,
"availabilities": "[]",
"external_id": null,
"external_sync": false,
"hrm_type_id": null,
"champion": false,
"timesheet_submission_disabled": false,
"offboarding_status": "not_initiated",
"offboarding_id": null,
"time_tracking_policy_id": null
},
"relationships": {
"organization": {
"data": {
"type": "organizations",
"id": "998"
}
},
"company": {
"meta": {
"included": false
}
},
"custom_role": {
"meta": {
"included": false
}
},
"manager": {
"meta": {
"included": false
}
},
"subsidiary": {
"meta": {
"included": false
}
},
"approval_policy_assignment": {
"meta": {
"included": false
}
},
"teams": {
"meta": {
"included": false
}
},
"service_types": {
"meta": {
"included": false
}
},
"custom_field_people": {
"meta": {
"included": false
}
},
"custom_field_attachments": {
"meta": {
"included": false
}
}
}
},
"meta": {}
}PATCH /api/v2/people/3571/archive
Headers
Accept: text/xml,application/xml,application/xhtml+xml,text/html;q=0.9,text/plain;q=0.8,image/png,*/*;q=0.5
Content-Type: application/vnd.api+jsonHeaders
Content-Type: application/vnd.api+json; charset=utf-8Body
{
"data": {
"id": "3571",
"type": "people",
"attributes": {
"agent": false,
"avatar_url": null,
"contact": {},
"deactivated_at": null,
"email": "person2540@email.com",
"first_name": "name",
"last_name": "surname",
"nickname": null,
"original_avatar_url": null,
"role_id": null,
"status_emoji": null,
"status_expires_at": null,
"status_text": null,
"time_off_status_sync": true,
"title": null,
"archived_at": "2026-04-01T06:07:56.000+02:00",
"autotracking": false,
"joined_at": null,
"last_seen_at": null,
"invited_at": null,
"is_user": false,
"user_id": null,
"tag_list": [],
"virtual": false,
"custom_fields": null,
"created_at": "2026-04-01T06:07:56.711+02:00",
"placeholder": true,
"color_id": null,
"sample_data": false,
"time_unlocked": false,
"time_unlocked_on": null,
"time_unlocked_start_date": null,
"time_unlocked_end_date": null,
"time_unlocked_period_id": null,
"time_unlocked_interval": null,
"last_activity_at": "2026-04-01T06:07:56.711+02:00",
"two_factor_auth": null,
"availabilities": "[]",
"external_id": null,
"external_sync": false,
"hrm_type_id": null,
"champion": false,
"timesheet_submission_disabled": false,
"offboarding_status": "not_initiated",
"offboarding_id": null,
"time_tracking_policy_id": null
},
"relationships": {
"organization": {
"data": {
"type": "organizations",
"id": "999"
}
},
"company": {
"meta": {
"included": false
}
},
"custom_role": {
"meta": {
"included": false
}
},
"manager": {
"meta": {
"included": false
}
},
"subsidiary": {
"meta": {
"included": false
}
},
"approval_policy_assignment": {
"meta": {
"included": false
}
},
"teams": {
"meta": {
"included": false
}
},
"service_types": {
"meta": {
"included": false
}
},
"custom_field_people": {
"meta": {
"included": false
}
},
"custom_field_attachments": {
"meta": {
"included": false
}
}
}
},
"meta": {}
}Archive a personPATCH/api/v2/people/{id}/archive
- id
number(required) Example: 1person id
PATCH /api/v2/people/3578/restore
Headers
Accept: text/xml,application/xml,application/xhtml+xml,text/html;q=0.9,text/plain;q=0.8,image/png,*/*;q=0.5
Content-Type: application/vnd.api+jsonHeaders
Content-Type: application/vnd.api+json; charset=utf-8Body
{
"data": {
"id": "3578",
"type": "people",
"attributes": {
"agent": false,
"avatar_url": null,
"contact": {},
"deactivated_at": null,
"email": "person2544@email.com",
"first_name": "name",
"last_name": "surname",
"nickname": null,
"original_avatar_url": null,
"role_id": null,
"status_emoji": null,
"status_expires_at": null,
"status_text": null,
"time_off_status_sync": true,
"title": null,
"archived_at": null,
"autotracking": false,
"joined_at": null,
"last_seen_at": null,
"invited_at": null,
"is_user": false,
"user_id": null,
"tag_list": [],
"virtual": false,
"custom_fields": null,
"created_at": "2026-04-01T06:07:57.039+02:00",
"placeholder": false,
"color_id": null,
"sample_data": false,
"time_unlocked": false,
"time_unlocked_on": null,
"time_unlocked_start_date": null,
"time_unlocked_end_date": null,
"time_unlocked_period_id": null,
"time_unlocked_interval": null,
"last_activity_at": "2026-04-01T06:07:57.039+02:00",
"two_factor_auth": null,
"availabilities": "[]",
"external_id": null,
"external_sync": false,
"hrm_type_id": 2,
"champion": false,
"timesheet_submission_disabled": false,
"offboarding_status": "not_initiated",
"offboarding_id": null,
"time_tracking_policy_id": null
},
"relationships": {
"organization": {
"data": {
"type": "organizations",
"id": "1002"
}
},
"company": {
"meta": {
"included": false
}
},
"custom_role": {
"meta": {
"included": false
}
},
"manager": {
"meta": {
"included": false
}
},
"subsidiary": {
"meta": {
"included": false
}
},
"approval_policy_assignment": {
"meta": {
"included": false
}
},
"teams": {
"meta": {
"included": false
}
},
"service_types": {
"meta": {
"included": false
}
},
"custom_field_people": {
"meta": {
"included": false
}
},
"custom_field_attachments": {
"meta": {
"included": false
}
}
}
},
"meta": {}
}PATCH /api/v2/people/3580/restore
Headers
Accept: text/xml,application/xml,application/xhtml+xml,text/html;q=0.9,text/plain;q=0.8,image/png,*/*;q=0.5
Content-Type: application/vnd.api+jsonHeaders
Content-Type: application/vnd.api+json; charset=utf-8Body
{
"errors": [
{
"status": "409",
"code": "not_archived",
"title": "Conflict error",
"meta": {},
"source": {}
}
]
}PATCH /api/v2/people/3584/restore
Headers
Accept: text/xml,application/xml,application/xhtml+xml,text/html;q=0.9,text/plain;q=0.8,image/png,*/*;q=0.5
Content-Type: application/vnd.api+jsonHeaders
Content-Type: application/vnd.api+json; charset=utf-8Body
{
"data": {
"id": "3584",
"type": "people",
"attributes": {
"agent": false,
"avatar_url": null,
"contact": {},
"deactivated_at": null,
"email": "person2547@email.com",
"first_name": "name",
"last_name": "surname",
"nickname": null,
"original_avatar_url": null,
"role_id": null,
"status_emoji": null,
"status_expires_at": null,
"status_text": null,
"time_off_status_sync": true,
"title": null,
"archived_at": null,
"autotracking": false,
"joined_at": null,
"last_seen_at": null,
"invited_at": null,
"is_user": false,
"user_id": null,
"tag_list": [],
"virtual": false,
"custom_fields": null,
"created_at": "2026-04-01T06:07:57.218+02:00",
"placeholder": false,
"color_id": null,
"sample_data": false,
"time_unlocked": false,
"time_unlocked_on": null,
"time_unlocked_start_date": null,
"time_unlocked_end_date": null,
"time_unlocked_period_id": null,
"time_unlocked_interval": null,
"last_activity_at": "2026-04-01T06:07:57.218+02:00",
"two_factor_auth": null,
"availabilities": "[]",
"external_id": null,
"external_sync": false,
"hrm_type_id": 2,
"champion": false,
"timesheet_submission_disabled": false,
"offboarding_status": "not_initiated",
"offboarding_id": null,
"time_tracking_policy_id": null
},
"relationships": {
"organization": {
"data": {
"type": "organizations",
"id": "1005"
}
},
"company": {
"meta": {
"included": false
}
},
"custom_role": {
"meta": {
"included": false
}
},
"manager": {
"meta": {
"included": false
}
},
"subsidiary": {
"meta": {
"included": false
}
},
"approval_policy_assignment": {
"meta": {
"included": false
}
},
"teams": {
"meta": {
"included": false
}
},
"service_types": {
"meta": {
"included": false
}
},
"custom_field_people": {
"meta": {
"included": false
}
},
"custom_field_attachments": {
"meta": {
"included": false
}
}
}
},
"meta": {}
}PATCH /api/v2/people/3587/restore
Headers
Accept: text/xml,application/xml,application/xhtml+xml,text/html;q=0.9,text/plain;q=0.8,image/png,*/*;q=0.5
Content-Type: application/vnd.api+jsonHeaders
Content-Type: application/vnd.api+json; charset=utf-8Body
{
"errors": [
{
"status": "422",
"code": "email_duplicate",
"title": "Invalid Attribute",
"detail": "has already been taken",
"meta": {},
"source": {
"pointer": "data/attributes/email"
}
}
]
}Restore a personPATCH/api/v2/people/{id}/restore
- id
number(required) Example: 1person id
PATCH /api/v2/people/merge
Headers
Accept: text/xml,application/xml,application/xhtml+xml,text/html;q=0.9,text/plain;q=0.8,image/png,*/*;q=0.5
Content-Type: application/vnd.api+jsonBody
{
"winner_id": 3589,
"loser_id": 3590
}Headers
Content-Type: application/vnd.api+json; charset=utf-8Body
{
"data": {
"id": "3589",
"type": "people",
"attributes": {
"agent": false,
"avatar_url": null,
"contact": {},
"deactivated_at": null,
"email": "person2548@email.com",
"first_name": "name",
"last_name": "surname",
"nickname": null,
"original_avatar_url": null,
"role_id": null,
"status_emoji": null,
"status_expires_at": null,
"status_text": null,
"time_off_status_sync": true,
"title": null,
"archived_at": null,
"autotracking": false,
"joined_at": null,
"last_seen_at": null,
"invited_at": null,
"is_user": false,
"user_id": null,
"tag_list": [],
"virtual": false,
"custom_fields": null,
"created_at": "2026-04-01T06:07:57.334+02:00",
"placeholder": false,
"color_id": null,
"sample_data": false,
"time_unlocked": false,
"time_unlocked_on": null,
"time_unlocked_start_date": null,
"time_unlocked_end_date": null,
"time_unlocked_period_id": null,
"time_unlocked_interval": null,
"last_activity_at": "2026-04-01T06:07:57.334+02:00",
"two_factor_auth": null,
"availabilities": "[]",
"external_id": null,
"external_sync": false,
"hrm_type_id": 2,
"champion": false,
"timesheet_submission_disabled": false,
"offboarding_status": "not_initiated",
"offboarding_id": null,
"time_tracking_policy_id": null
},
"relationships": {
"organization": {
"data": {
"type": "organizations",
"id": "1007"
}
},
"company": {
"meta": {
"included": false
}
},
"custom_role": {
"meta": {
"included": false
}
},
"manager": {
"meta": {
"included": false
}
},
"subsidiary": {
"meta": {
"included": false
}
},
"approval_policy_assignment": {
"meta": {
"included": false
}
},
"teams": {
"meta": {
"included": false
}
},
"service_types": {
"meta": {
"included": false
}
},
"custom_field_people": {
"meta": {
"included": false
}
},
"custom_field_attachments": {
"meta": {
"included": false
}
}
}
},
"meta": {}
}PATCH /api/v2/people/3602/virtualize
Headers
Accept: text/xml,application/xml,application/xhtml+xml,text/html;q=0.9,text/plain;q=0.8,image/png,*/*;q=0.5
Content-Type: application/vnd.api+jsonHeaders
Content-Type: application/vnd.api+json; charset=utf-8Body
{
"data": {
"id": "3602",
"type": "people",
"attributes": {
"agent": false,
"avatar_url": null,
"contact": {},
"deactivated_at": null,
"email": "user3529@email.com",
"first_name": "name",
"last_name": "surname",
"nickname": null,
"original_avatar_url": null,
"role_id": 3,
"status_emoji": null,
"status_expires_at": null,
"status_text": null,
"time_off_status_sync": true,
"title": null,
"archived_at": null,
"autotracking": false,
"joined_at": null,
"last_seen_at": null,
"invited_at": null,
"is_user": true,
"user_id": 3579,
"tag_list": [],
"virtual": true,
"custom_fields": null,
"created_at": "2026-04-01T06:07:57.658+02:00",
"placeholder": false,
"color_id": null,
"sample_data": false,
"time_unlocked": false,
"time_unlocked_on": null,
"time_unlocked_start_date": null,
"time_unlocked_end_date": null,
"time_unlocked_period_id": null,
"time_unlocked_interval": null,
"last_activity_at": "2026-04-01T06:07:57.658+02:00",
"two_factor_auth": false,
"availabilities": "[]",
"external_id": null,
"external_sync": false,
"hrm_type_id": 1,
"champion": false,
"timesheet_submission_disabled": false,
"offboarding_status": "not_initiated",
"offboarding_id": null,
"time_tracking_policy_id": null
},
"relationships": {
"organization": {
"data": {
"type": "organizations",
"id": "1011"
}
},
"company": {
"meta": {
"included": false
}
},
"custom_role": {
"meta": {
"included": false
}
},
"manager": {
"meta": {
"included": false
}
},
"subsidiary": {
"meta": {
"included": false
}
},
"approval_policy_assignment": {
"meta": {
"included": false
}
},
"teams": {
"meta": {
"included": false
}
},
"service_types": {
"meta": {
"included": false
}
},
"custom_field_people": {
"meta": {
"included": false
}
},
"custom_field_attachments": {
"meta": {
"included": false
}
}
}
},
"meta": {}
}Virtualize a personPATCH/api/v2/people/{id}/virtualize
- id
number(required) Example: 1person id
PATCH /api/v2/people/3608/regenerate_recovery_codes
Headers
Accept: text/xml,application/xml,application/xhtml+xml,text/html;q=0.9,text/plain;q=0.8,image/png,*/*;q=0.5
Content-Type: application/vnd.api+jsonBody
{
"data": {
"type": "people",
"attributes": {
"password": "test_password"
}
}
}Regenerate 2FA recovery codesPATCH/api/v2/people/{id}/regenerate_recovery_codes
- id
number(required) Example: 1person id
Generated by aglio on 01 Apr 2026