---
title: "Create a firm task · Firm Tasks · Practice Manager API · COUNT Partner API"
description: "Creates a task in the firm’s workspace or under one of its clients. POST /firm-partners/firm/tasks"
canonical: "https://developers.getcount.com/practice-manager/reference/firm-tasks/create-firm-task"
source: "https://developers.getcount.com/practice-manager/reference/firm-tasks/create-firm-task"
---
[Firm Tasks](https://developers.getcount.com/practice-manager/reference/firm-tasks) / Create a firm task

# Create a firm task

POST `/firm-partners/firm/tasks`

Creates a task in the firm’s workspace or under one of its clients.

Without `assigneeUuid` the task is assigned to the member the key acts as. Priority defaults to `low`, visibility to `firm-team`, and the status to the firm’s Not Started status. `customId` is generated.

HMAC signature only

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

#### Request body

`name` string required

Task title.

`type` string required

Task type. Use `custom` for ordinary work, or `INTERNAL_TASK` for a firm-only task.

`description` string

Task details. HTML is sanitized.

`priority` enum

Defaults to `low`.

One of: `high`, `medium`, `low`

`visibility` enum

Defaults to `firm-team`.

One of: `firm-team`, `team-only`, `firm-only`

`deadline` date

Due date (YYYY-MM-DD).

`clientWorkspaceUuid` uuid

Client workspace to file the task under. Omit for the firm’s own workspace.

`assigneeUuid` uuid

Firm member user id (`user.id` from List firm members). Defaults to the member the key acts as.

`projectUuid` uuid

Project from List firm projects. Without `clientWorkspaceUuid`, the task is created in the project’s workspace; with it, the two must match.

`budgetedMinutes` integer

Time budget in minutes.

`isTimeTrackable` boolean

Whether staff can log time against the task. Defaults to false.

#### Responses

`201` The created firm task.

`400` `type` or `name` is missing, a value is invalid (such as `deadline`), or the project belongs to a different client workspace than `clientWorkspaceUuid`.

`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 client workspace, assignee or project is not part of the firm.

`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 task](https://developers.getcount.com/practice-manager/reference/firm-tasks/get-firm-task) [Next PATCH Update a firm task](https://developers.getcount.com/practice-manager/reference/firm-tasks/update-firm-task)

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

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/tasks';
const timestamp = Math.floor(Date.now() / 1000).toString();
const body = {
  "name": "Q3 sales tax filing",
  "type": "custom",
  "description": "File the California return for Q3.",
  "priority": "high",
  "deadline": "2026-10-31",
  "clientWorkspaceUuid": "5e4d3c2b-1a09-4f8e-8d7c-6b5a49382716",
  "assigneeUuid": "2c3d4e5f-6a7b-4c8d-9e0f-1a2b3c4d5e6f",
  "budgetedMinutes": 90,
  "isTimeTrackable": true
};
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/tasks`, {
  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": "Success on creating firm task.",
  "data": {
    "task": {
      "id": "3f4a5b6c-7d8e-4f9a-8b0c-1d2e3f4a5b6c",
      "name": "Q3 sales tax filing",
      "type": "custom",
      "description": "File the California return for Q3.",
      "status": "not_started",
      "priority": "high",
      "visibility": "firm-team",
      "deadlineDate": "2026-10-31T00:00:00.000Z",
      "startDate": null,
      "completedAt": null,
      "customId": "TODO-42",
      "budgetedMinutes": 90,
      "isTimeTrackable": true,
      "totalMinutesTracked": "0",
      "creatorEntity": "accounting-firm",
      "source": null,
      "isFromPeriodClose": false,
      "isFromRecurringSeries": false,
      "isRecurringSourceTask": false,
      "assignedAt": "2026-10-21T10:04:05.000Z",
      "assignee": {
        "id": 5521,
        "firstName": "Dana",
        "lastName": "Okafor",
        "avatarUrl": null
      },
      "assigner": {
        "id": 5510,
        "firstName": "Sam",
        "lastName": "Rivera",
        "avatarUrl": null
      },
      "createdBy": {
        "id": 5510,
        "firstName": "Sam",
        "lastName": "Rivera",
        "avatarUrl": null
      },
      "taskStatus": {
        "id": 311,
        "name": "Not Started",
        "statusType": "not_started",
        "color": "#ACB2BD",
        "order": 0
      },
      "projects": [],
      "team": {
        "id": "5e4d3c2b-1a09-4f8e-8d7c-6b5a49382716",
        "name": "Harbor Coffee Co."
      },
      "createdAt": "2026-10-21T10:04:05.000Z",
      "updatedAt": "2026-10-21T10:04:05.000Z"
    }
  }
}
```
