Create a firm task
/firm-partners/firm/tasksCreates 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.
Request body
namestringrequiredTask title.
typestringrequiredTask type. Use `custom` for ordinary work, or `INTERNAL_TASK` for a firm-only task.
descriptionstringTask details. HTML is sanitized.
priorityenumDefaults to `low`.
One of: high, medium, low
visibilityenumDefaults to `firm-team`.
One of: firm-team, team-only, firm-only
deadlinedateDue date (YYYY-MM-DD).
clientWorkspaceUuiduuidClient workspace to file the task under. Omit for the firm’s own workspace.
assigneeUuiduuidFirm member user id (`user.id` from List firm members). Defaults to the member the key acts as.
projectUuiduuidProject from List firm projects. Without `clientWorkspaceUuid`, the task is created in the project’s workspace; with it, the two must match.
budgetedMinutesintegerTime budget in minutes.
isTimeTrackablebooleanWhether 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. Troubleshoot403The 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. Troubleshoot404The 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). Troubleshoothttps://api.getcount.com/firm-partners/firm/tasksimport 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());{
"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"
}
}
}