Tasks/Create a task

Create a task

POST/partners/tasks

Creates a new task.

Required body field: `type`. If `assigneeId` is omitted, the partner-acting user is assigned. JSON only — no file attachments.

HMAC signature + Bearer access token

Try this request

Projects API People API

Request body

typestringrequired

Task type identifier.

namestring

Task title.

descriptionstring

Task details.

prioritystring

Priority level.

deadlinedate

Due date (YYYY-MM-DD).

customIdstring

External reference id.

visibilityenum

Visibility scope. INTERNAL_TASK is always created as firm-only.

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

assigneeIduuid

Assignee UUID or workspace-scoped numeric id.

statusIduuid

Task status UUID or workspace-scoped numeric id.

projectIduuid

Project UUID or workspace-scoped numeric id.

tagsarray

Array of tag UUIDs or numeric ids (homogeneous).

Responses

201Task created successfully.

400Validation failed — for example missing type or mixed tag id kinds.

401Missing or invalid HMAC signature, expired timestamp, or invalid Bearer token. Troubleshoot

403The credential does not have access to this workspace or resource. Troubleshoot

429Rate limit exceeded (100 requests per minute per clientId). Retry after the Retry-After header. Troubleshoot

POSThttps://api.getcount.com/partners/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 ACCESS_TOKEN = process.env.COUNT_ACCESS_TOKEN;

const method = 'POST';
const signingPath = '/tasks';
const timestamp = Math.floor(Date.now() / 1000).toString();
const body = {
  "type": "INTERNAL_TASK",
  "name": "Review wireframes",
  "description": "Review and approve wireframes before development.",
  "priority": "medium",
  "deadline": "2026-04-15",
  "assigneeId": "f1a2b3c4-d5e6-4789-a012-3456789abcde",
  "projectId": "11223344-5566-7788-99aa-bbccddeeff00"
};
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/tasks`, {
  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

{
  "status": "success",
  "message": "Success on creating task",
  "data": {
    "task": {
      "id": "22334455-6677-8899-aabb-ccddeeff0011",
      "name": "Review wireframes",
      "type": "INTERNAL_TASK",
      "description": "Review and approve wireframes before development.",
      "priority": "medium",
      "deadline": "2026-04-15",
      "customId": "TASK-1042",
      "visibility": "firm-team",
      "assignee": {
        "uuid": "f1a2b3c4-d5e6-4789-a012-3456789abcde",
        "firstName": "Jane",
        "lastName": "Smith"
      },
      "project": {
        "uuid": "11223344-5566-7788-99aa-bbccddeeff00",
        "name": "Website Redesign"
      },
      "tags": [],
      "createdAt": "2026-01-15T10:30:00.000Z",
      "updatedAt": "2026-01-28T14:22:30.000Z"
    }
  }
}