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

iduuid

Person identifier (UUID). Use in path parameters.

firstNamestring

Person's first name.

lastNamestring

Person's last name.

emailstring

Email address, or null.

phonestring

Phone number, or null.

typeenum

Kind of person.

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

enabledboolean

Whether the person is active in the workspace.

terminatedboolean

Whether the person has been terminated.

rolearray

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

positionstring

The title of the person's primary job.

createdAtdatetime

ISO 8601 creation timestamp.

updatedAtdatetime

ISO 8601 last update timestamp.

Example
{
  "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.

Endpoints

GET
List people/firm-partners/workspace/people

Returns a paginated list of people in the workspace.

GET
Get a person/firm-partners/workspace/people/{uuid}

Retrieves a single person by UUID, with their address, primary job, accounts and vendor.

POST
Create a person/firm-partners/workspace/people

Creates a person, optionally with a primary job and expense reporting accounts.

PATCH
Update a person/firm-partners/workspace/people/{uuid}

Updates a person's profile, roles, accounts or primary job.

DELETE
Delete a person/firm-partners/workspace/people/{uuid}

Deletes a person.

PATCH
Activate or deactivate a person/firm-partners/workspace/people/{uuid}/enabled

Sets whether a person is active.

PATCH
Terminate a person/firm-partners/workspace/people/{uuid}/terminate

Ends a person's employment.

POST
Resend the sign-in invite/firm-partners/workspace/people/{uuid}/resend-invite

Emails the person a new temporary password.

POST
Resend the payroll onboarding email/firm-partners/workspace/people/{uuid}/resend-onboarding-email

Emails a payroll employee their onboarding invite again.

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.

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.

GET
List a person's jobs/firm-partners/workspace/people/{uuid}/jobs

Returns the person's jobs, primary first, each with its work location.

GET
Get a job/firm-partners/workspace/people/{uuid}/jobs/{jobUuid}

Returns one of the person's jobs.

POST
Create a job/firm-partners/workspace/people/{uuid}/jobs

Adds a job to a person in an existing position.

PATCH
Update a job/firm-partners/workspace/people/{uuid}/jobs/{jobUuid}

Updates one of the person's jobs.

DELETE
Delete a job/firm-partners/workspace/people/{uuid}/jobs/{jobUuid}

Removes one of the person's jobs.