---
title: "Create a person · People · COUNT Partner API"
description: "Creates a person, optionally with a primary job and expense reporting accounts. POST /partners/people"
canonical: "https://developers.getcount.com/reference/people/create-person"
source: "https://developers.getcount.com/reference/people/create-person"
---
[People](https://developers.getcount.com/reference/people) / Create a person

# Create a person

POST `/partners/people`

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

Giving the person a role that signs in (`time tracking`, `sales rep`, `expense reporting`) needs an email address. Bank accounts (`externalAccounts`), a tax identification number (`taxInfo.taxNumber`) and the `payroll` role are refused with 400.

HMAC signature + Bearer access token

[Try this request](https://developers.getcount.com/tools/try-it?method=POST&path=%2Fpartners%2Fpeople&body=%7B%0A++%22type%22%3A+%22Employee%22%2C%0A++%22firstName%22%3A+%22Jane%22%2C%0A++%22lastName%22%3A+%22Smith%22%2C%0A++%22email%22%3A+%22jane.smith%40acme.com%22%2C%0A++%22role%22%3A+%5B%0A++++%22time+tracking%22%0A++%5D%2C%0A++%22sendEmail%22%3A+true%2C%0A++%22jobDetails%22%3A+%7B%0A++++%22title%22%3A+%22Barista%22%2C%0A++++%22rate%22%3A+%2225%22%2C%0A++++%22paymentUnit%22%3A+%22hour%22%2C%0A++++%22compensationType%22%3A+%22hourly%22%2C%0A++++%22hireDate%22%3A+%222026-11-01%22%0A++%7D%0A%7D)

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

#### Request body

`type` enum

Kind of person.

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

`firstName` string

First name.

`middleName` string

Middle name.

`lastName` string

Last name.

`email` string

Email address.

`phone` string

Phone number.

`employeeNumber` string

Your own number for the person.

`role` array

Any of `time tracking`, `sales rep`, `expense reporting`. `payroll` is refused.

`accountUuids` array

Up to 200 transacting account UUIDs (`isPhysicalAccount: true` in List accounts) the person spends from as an expense reporter. Any other account is refused with 400.

`sendEmail` boolean

Email the person their sign-in invite.

`address` object

Home address: `street`, `street2`, `city`, `state`, `zipCode`, `country`.

`jobDetails` object

The person's primary job, with the fields of Create a job.

`title` string

The name of an existing position in the workspace, matched without regard to case. The job takes that position. Required on create.

`rate` string

Wage, zero or more. Required on create.

`paymentUnit` string

What the rate is paid per, for example `hour`. Required on create.

`compensationType` enum

Required on create.

One of: `hourly`, `salary`, `commission`

`hireDate` date

First day in the job (YYYY-MM-DD).

`employmentStatus` enum

Employment status.

One of: `full_time`, `part_time`, `seasonal`, `variable`

`jobLocationType` string

Where the job is worked, for example `office` or `remote`.

`locationUuid` uuid

Work location UUID, the `location.id` on one of the workspace's jobs; null clears it. A location from another workspace returns 404.

`flsaStatus` string

FLSA status.

`paymentMethod` enum

How the job is paid.

One of: `direct_deposit`, `check`

`overtimeEligible` boolean

Whether the job earns overtime.

`primary` boolean

Whether this is the person's primary job. A person has one.

`notes` string

Notes.

#### Responses

`201` The new person.

`400` Validation failed; a role that signs in without an email; `externalAccounts`, `taxInfo.taxNumber` or the `payroll` role sent; `accountIDs` sent instead of `accountUuids`; or an account that is not a transacting account.

`404` An account, position (`jobDetails.title`) or work location was not found.

`409` Two positions share the name in `jobDetails.title`.

`401` Missing or invalid HMAC signature, expired timestamp, or invalid Bearer token. [Troubleshoot](https://developers.getcount.com/getting-started/errors#error-401)

`403` The credential does not have access to this workspace or resource. [Troubleshoot](https://developers.getcount.com/getting-started/errors#error-403)

`429` Rate limit exceeded (100 requests per minute per user of each app, or 10,000 per minute per app). Retry after the Retry-After header. [Troubleshoot](https://developers.getcount.com/getting-started/errors#error-429)

[Previous GET Get a person](https://developers.getcount.com/reference/people/get-person) [Next PATCH Update a person](https://developers.getcount.com/reference/people/update-person)

POST `https://api.getcount.com/partners/people`

Request

```javascript
import crypto from 'node:crypto';

const BASE_URL = 'https://api.getcount.com';
const CLIENT_ID = process.env.COUNT_CLIENT_ID;
const CLIENT_SECRET = process.env.COUNT_CLIENT_SECRET;
const ACCESS_TOKEN = process.env.COUNT_ACCESS_TOKEN;

const method = 'POST';
const signingPath = '/people';
const timestamp = Math.floor(Date.now() / 1000).toString();
const body = {
  "type": "Employee",
  "firstName": "Jane",
  "lastName": "Smith",
  "email": "jane.smith@acme.com",
  "role": [
    "time tracking"
  ],
  "sendEmail": true,
  "jobDetails": {
    "title": "Barista",
    "rate": "25",
    "paymentUnit": "hour",
    "compensationType": "hourly",
    "hireDate": "2026-11-01"
  }
};
const bodyString = JSON.stringify(body);

const bodyHash = crypto.createHash('sha256').update(bodyString).digest('hex');
const baseString = `${method}:${signingPath}:${timestamp}:${bodyHash}`;
const signature = crypto.createHmac('sha256', CLIENT_SECRET).update(baseString).digest('hex');

const response = await fetch(`${BASE_URL}/partners/people`, {
  method,
  headers: {
    'x-client-id': CLIENT_ID,
    'x-timestamp': timestamp,
    'x-signature': signature,
    'Content-Type': 'application/json',
    Authorization: `Bearer ${ACCESS_TOKEN}`,
  },
  body: bodyString,
});

console.log(await response.json());
```

Response · 201

```json
{
  "status": "success",
  "message": "Success on creating a person",
  "data": {
    "people": {
      "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"
    }
  }
}
```
