Firm TasksCreate 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

Request body

namestringrequired

Task title.

typestringrequired

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

descriptionstring

Task details. HTML is sanitized.

priorityenum

Defaults to `low`.

One of: high, medium, low

visibilityenum

Defaults to `firm-team`.

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

deadlinedate

Due date (YYYY-MM-DD).

clientWorkspaceUuiduuid

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

assigneeUuiduuid

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

projectUuiduuid

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

budgetedMinutesinteger

Time budget in minutes.

isTimeTrackableboolean

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

Responses

201The 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`.
401Missing signing headers, an invalid HMAC signature, or a timestamp more than 5 minutes off. Troubleshoot
403The 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
404The client workspace, assignee or project is not part of the firm.
429Rate limit exceeded (100 requests per minute per firm user of each app, or 10,000 per minute per app). Troubleshoot
POSThttps://api.getcount.com/firm-partners/firm/tasks
Request
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
{
  "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"
    }
  }
}