Skip to main content
The Tasks API is currently in public beta and may change based on feedback. Whenever possible, we will maintain backward compatibility and provide advance notice of any breaking changes.

Overview

A task is a unit of outreach work — sending an email, making a phone call, engaging on LinkedIn, or completing a manual action item — tied to a person and assigned to a user. Tasks track their own type, status, priority, and due date. The Tasks API lets you manage these resources programmatically: To export tasks in bulk, use the Bulk API instead.

Usage

Request format

The base URL of all API requests to the Tasks API is:
All APIs are built on REST principles and use standard HTTP methods to perform operations.

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.