---
title: "People · Practice Manager API · COUNT Partner API"
description: "People are the employees, contractors and other contacts of a workspace. Create and edit them, switch them on and off, terminate them, manage their jobs and…"
canonical: "https://developers.getcount.com/practice-manager/reference/people"
source: "https://developers.getcount.com/practice-manager/reference/people"
---
Practice Manager API

# People

People are the employees, contractors and other contacts of a workspace. Create and edit them, switch them on and off, terminate them, manage their jobs and expense reporting, and resend their invites.

Last updated 2026-11-18

## Overview

The People API covers the person records of a workspace: employees, contractors, volunteers and other contacts used for payroll, time tracking and expense reporting. Every person and every job is identified by the UUID returned as `id`.

Your integration can list, get, create, update and delete people; activate and deactivate them; terminate them; add and remove jobs; make them expense reporters; and resend their sign-in invite or payroll onboarding email.

Some things stay in the COUNT app: bank accounts, tax identification numbers (SSN), identity checks, and adding a person to or removing them from payroll.

## Key concepts

### Identification

Reference a person by the UUID returned as `id`, a job by its own `id`, accounts by `accountUuids` from List accounts, and a work location by `locationUuid`. Numeric ids such as `accountIDs`, `locationId` and `originalJobId` are refused.

### Deleted people

A deleted person no longer appears in List people, and every route returns 404 for their UUID.

### Payroll stays in COUNT

A partner write cannot add the `payroll` role or take it away, set bank accounts or a tax identification number, or delete a job that is synced to the payroll provider. A person already in payroll keeps the role on updates.

## The person object

Core fields of a person record. `address`, `remoteWorkAddress`, `jobs`, `accounts` and `vendor` are embedded when present. Sign-in secrets, tax identification numbers (also on a contractor's vendor), bank account and routing numbers, and internal numeric ids are never returned.

#### Attributes

`id` uuid

Person identifier (UUID). Use in path parameters.

`firstName` string

Person's first name.

`lastName` string

Person's last name.

`email` string

Email address, or null.

`phone` string

Phone number, or null.

`type` enum

Kind of person.

One of: `Employee`, `Contractor`, `Volunteer`, `Donor`, `Other`

`enabled` boolean

Whether the person is active in the workspace.

`terminated` boolean

Whether the person has been terminated.

`role` array

What the person can do in COUNT: `time tracking`, `sales rep`, `expense reporting`, `payroll`.

`position` string

The title of the person's primary job.

`createdAt` datetime

ISO 8601 creation timestamp.

`updatedAt` datetime

ISO 8601 last update timestamp.

Example

```json
{
  "id": "f1a2b3c4-d5e6-4789-a012-3456789abcde",
  "firstName": "Jane",
  "lastName": "Smith",
  "email": "jane.smith@acme.com",
  "phone": "+19876543210",
  "type": "Employee",
  "enabled": true,
  "terminated": false,
  "role": [
    "time tracking"
  ],
  "position": "Barista",
  "createdAt": "2026-01-15T10:30:00.000Z",
  "updatedAt": "2026-01-28T14:22:30.000Z"
}
```

Scope and permissions

Reads need the `people:read` scope; writes need `people:write`. List people needs the `view_people` permission and Get a person `view_people` or `view_payroll`. Every write and every job route needs `manage_people`, except Terminate a person and Resend the payroll onboarding email, which need `manage_payroll`.

MCP equivalent

COUNT_list_people, COUNT_get_person, COUNT_delete_person, COUNT_set_person_enabled, COUNT_terminate_person, COUNT_resend_person_invite, COUNT_resend_payroll_onboarding_email, COUNT_add_expense_reporter, COUNT_remove_expense_reporter, COUNT_list_person_jobs, COUNT_get_person_job, COUNT_create_person_job, COUNT_update_person_job and COUNT_delete_person_job. MCP creates and updates people with the payroll tools COUNT_create_person and COUNT_update_person. On a client that can show a form, COUNT_terminate_person asks the user to confirm first.

Used by time entries and expense receipts

Time entry create payloads require `peopleUuid` from this API. Expense receipt flows reference people through their expense reporting accounts.

## Related

- [Time Entries API](https://developers.getcount.com/practice-manager/reference/time-entries)
- [Chart of Accounts API](https://developers.getcount.com/practice-manager/reference/chart-of-accounts)
- [Tasks API](https://developers.getcount.com/practice-manager/reference/tasks)

## Endpoints

[GET List people `/firm-partners/workspace/people` Returns a paginated list of people in the workspace.](https://developers.getcount.com/practice-manager/reference/people/list-people) [GET Get a person `/firm-partners/workspace/people/{uuid}` Retrieves a single person by UUID, with their address, primary job, accounts and vendor.](https://developers.getcount.com/practice-manager/reference/people/get-person) [POST Create a person `/firm-partners/workspace/people` Creates a person, optionally with a primary job and expense reporting accounts.](https://developers.getcount.com/practice-manager/reference/people/create-person) [PATCH Update a person `/firm-partners/workspace/people/{uuid}` Updates a person's profile, roles, accounts or primary job.](https://developers.getcount.com/practice-manager/reference/people/update-person) [DELETE Delete a person `/firm-partners/workspace/people/{uuid}` Deletes a person.](https://developers.getcount.com/practice-manager/reference/people/delete-person) [PATCH Activate or deactivate a person `/firm-partners/workspace/people/{uuid}/enabled` Sets whether a person is active.](https://developers.getcount.com/practice-manager/reference/people/set-person-enabled) [PATCH Terminate a person `/firm-partners/workspace/people/{uuid}/terminate` Ends a person's employment.](https://developers.getcount.com/practice-manager/reference/people/terminate-person) [POST Resend the sign-in invite `/firm-partners/workspace/people/{uuid}/resend-invite` Emails the person a new temporary password.](https://developers.getcount.com/practice-manager/reference/people/resend-person-invite) [POST Resend the payroll onboarding email `/firm-partners/workspace/people/{uuid}/resend-onboarding-email` Emails a payroll employee their onboarding invite again.](https://developers.getcount.com/practice-manager/reference/people/resend-payroll-onboarding-email) [POST Make a person an expense reporter `/firm-partners/workspace/people/{uuid}/expense-reporter` Gives the person the expense reporting role and the accounts they spend from.](https://developers.getcount.com/practice-manager/reference/people/add-expense-reporter) [DELETE Remove a person as an expense reporter `/firm-partners/workspace/people/{uuid}/expense-reporter` Takes away the expense reporting role and unlinks the person's accounts.](https://developers.getcount.com/practice-manager/reference/people/remove-expense-reporter) [GET List a person's jobs `/firm-partners/workspace/people/{uuid}/jobs` Returns the person's jobs, primary first, each with its work location.](https://developers.getcount.com/practice-manager/reference/people/list-person-jobs) [GET Get a job `/firm-partners/workspace/people/{uuid}/jobs/{jobUuid}` Returns one of the person's jobs.](https://developers.getcount.com/practice-manager/reference/people/get-person-job) [POST Create a job `/firm-partners/workspace/people/{uuid}/jobs` Adds a job to a person in an existing position.](https://developers.getcount.com/practice-manager/reference/people/create-person-job) [PATCH Update a job `/firm-partners/workspace/people/{uuid}/jobs/{jobUuid}` Updates one of the person's jobs.](https://developers.getcount.com/practice-manager/reference/people/update-person-job) [DELETE Delete a job `/firm-partners/workspace/people/{uuid}/jobs/{jobUuid}` Removes one of the person's jobs.](https://developers.getcount.com/practice-manager/reference/people/delete-person-job)
