---
title: "Create a firm time entry · Firm Time Entries · Practice Manager API · COUNT Partner API"
description: "Logs time for a staff member. POST /firm-partners/firm/time-entries"
canonical: "https://developers.getcount.com/practice-manager/reference/firm-time-entries/create-firm-time-entry"
source: "https://developers.getcount.com/practice-manager/reference/firm-time-entries/create-firm-time-entry"
---
[Firm Time Entries](https://developers.getcount.com/practice-manager/reference/firm-time-entries) / Create a firm time entry

# Create a firm time entry

POST `/firm-partners/firm/time-entries`

Logs time for a staff member.

Unknown fields are ignored.

HMAC signature only

[Firm tasks](https://developers.getcount.com/practice-manager/reference/firm-tasks) [Firm, clients & members](https://developers.getcount.com/practice-manager/reference/firm)

#### Request body

`peopleUuid` uuid required

Staff person UUID in the firm’s workspace.

`date` date required

Day the work was done (YYYY-MM-DD).

`minutes` integer required

Minutes worked. A positive whole number.

`notes` string

What the time was spent on. Omit rather than send null.

`isBillable` boolean

Defaults to true.

`customerUuid` uuid

An active customer in the firm’s workspace.

`projectUuid` uuid

A project in the firm’s workspace.

`productServiceUuid` uuid

A service in the firm’s workspace.

`taskUuid` uuid

A firm task. Its project, if in the firm’s workspace, overrides `projectUuid` and `customerUuid`.

#### Responses

`201` The created time entry.

`400` `peopleUuid`, `date` or `minutes` is missing or invalid, or the customer is inactive.

`401` Missing signing headers, an invalid HMAC signature, or a timestamp more than 5 minutes off. [Troubleshoot](https://developers.getcount.com/practice-manager/authentication#errors)

`403` The API key is inactive, its scope does not cover this route, or it is limited to selected client workspaces and the route is firm-wide. [Troubleshoot](https://developers.getcount.com/practice-manager/authentication#errors)

`404` The staff member, customer, project, service or task does not exist in the firm’s workspace.

`429` Rate limit exceeded (100 requests per minute per firm user of each app, or 10,000 per minute per app). [Troubleshoot](https://developers.getcount.com/practice-manager/authentication#errors)

[Previous GET Get a firm time entry](https://developers.getcount.com/practice-manager/reference/firm-time-entries/get-firm-time-entry) [Next PATCH Update a firm time entry](https://developers.getcount.com/practice-manager/reference/firm-time-entries/update-firm-time-entry)

POST `https://api.getcount.com/firm-partners/firm/time-entries`

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 method = 'POST';
const signingPath = '/firm/time-entries';
const timestamp = Math.floor(Date.now() / 1000).toString();
const body = {
  "peopleUuid": "8e9f0a1b-2c3d-4e4f-9a5b-6c7d8e9f0a1b",
  "date": "2026-10-20",
  "minutes": 90,
  "notes": "Payroll reconciliation",
  "isBillable": true,
  "customerUuid": "9f0a1b2c-3d4e-4f5a-8b6c-7d8e9f0a1b2c",
  "productServiceUuid": "0a1b2c3d-4e5f-4a6b-9c7d-8e9f0a1b2c3d"
};
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}/firm-partners/firm/time-entries`, {
  method,
  headers: {
    'x-client-id': CLIENT_ID,
    'x-timestamp': timestamp,
    'x-signature': signature,
    'Content-Type': 'application/json',
  },
  body: bodyString,
});

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

Response · 201

```json
{
  "status": "success",
  "message": "Time entry created successfully",
  "data": {
    "timeEntry": {
      "id": "6c7d8e9f-0a1b-4c2d-8e3f-4a5b6c7d8e9f",
      "date": "2026-10-20",
      "minutes": 90,
      "notes": "Payroll reconciliation",
      "isBillable": true,
      "isBilled": false,
      "unitPrice": null,
      "people": {
        "id": 8812,
        "firstName": "Dana",
        "lastName": "Okafor",
        "email": "dana@northwind.example",
        "avatarUrl": null,
        "type": "employee"
      },
      "project": {
        "id": 402,
        "name": "Harbor Coffee – Monthly close"
      },
      "customer": {
        "id": 9931,
        "customer": "Harbor Coffee Co."
      },
      "productService": {
        "id": 77,
        "name": "Bookkeeping (hourly)",
        "unitPrice": "150.0000",
        "pricingMethod": "hourly"
      },
      "task": {
        "id": 120345,
        "name": "Q3 sales tax filing"
      },
      "createdAt": "2026-10-21T10:04:05.000Z",
      "updatedAt": "2026-10-21T10:04:05.000Z"
    }
  }
}
```
