Skip to main content

​
Overview

A task is a unit of outreach work such as sending an email, making a phone call, or completing a manual action. Tasks are tied to people and assigned to users. Every task tracks its own type, status, priority, and due date. Use the Tasks API to create follow-up work from another system, update assignments and due dates, or export task activity for reporting.

​
Usage

​
Request format

The base URL of all API requests to the Tasks API is:

​
Authentication

API keys are used to authenticate requests to the Tasks API. You can generate an API key in Unify by navigating to Settings → Developers. To authenticate a request, include the following header in your request:
Replace <token> with your Unify API key.

​
Pagination

List endpoints are cursor-paginated. Each response includes a next_cursor value; pass it as the cursor query parameter to fetch the next page. A null next_cursor means there are no more results.

​
Rate limits

The Tasks API is rate-limited to 100,000 requests per five minute window. We may introduce daily limits in the future to prevent extraordinary usage.

​
OpenAPI specification

The OpenAPI specification can be found here.