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
iduuidPerson identifier (UUID). Use in path parameters.
firstNamestringPerson's first name.
lastNamestringPerson's last name.
emailstringEmail address, or null.
phonestringPhone number, or null.
typeenumKind of person.
One of: Employee, Contractor, Volunteer, Donor, Other
enabledbooleanWhether the person is active in the workspace.
terminatedbooleanWhether the person has been terminated.
rolearrayWhat the person can do in COUNT: `time tracking`, `sales rep`, `expense reporting`, `payroll`.
positionstringThe title of the person's primary job.
createdAtdatetimeISO 8601 creation timestamp.
updatedAtdatetimeISO 8601 last update timestamp.
{
"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
Endpoints
/firm-partners/workspace/peopleReturns a paginated list of people in the workspace.
/firm-partners/workspace/people/{uuid}Retrieves a single person by UUID, with their address, primary job, accounts and vendor.
/firm-partners/workspace/peopleCreates a person, optionally with a primary job and expense reporting accounts.
/firm-partners/workspace/people/{uuid}Updates a person's profile, roles, accounts or primary job.
/firm-partners/workspace/people/{uuid}Deletes a person.
/firm-partners/workspace/people/{uuid}/enabledSets whether a person is active.
/firm-partners/workspace/people/{uuid}/terminateEnds a person's employment.
/firm-partners/workspace/people/{uuid}/resend-inviteEmails the person a new temporary password.
/firm-partners/workspace/people/{uuid}/resend-onboarding-emailEmails a payroll employee their onboarding invite again.
/firm-partners/workspace/people/{uuid}/expense-reporterGives the person the expense reporting role and the accounts they spend from.
/firm-partners/workspace/people/{uuid}/expense-reporterTakes away the expense reporting role and unlinks the person's accounts.
/firm-partners/workspace/people/{uuid}/jobsReturns the person's jobs, primary first, each with its work location.
/firm-partners/workspace/people/{uuid}/jobs/{jobUuid}Returns one of the person's jobs.
/firm-partners/workspace/people/{uuid}/jobsAdds a job to a person in an existing position.
/firm-partners/workspace/people/{uuid}/jobs/{jobUuid}Updates one of the person's jobs.
/firm-partners/workspace/people/{uuid}/jobs/{jobUuid}Removes one of the person's jobs.
