Teamwork.com

Read and write Teamwork.com projects, task lists, tasks, subtasks, milestones, time entries, comments and custom fields.

Run client delivery in Teamwork.com from CRM and finance events and bring billable time back to invoicing.

Build a flow with Teamwork.com Provider API documentation

Source actions

Destination actions

Data types

Validation status

Implemented · fixture tested.

Implementation is checked against provider-shaped fixtures for every action, authentication failures, rate limits, pagination and duplicate safety. Provider sandbox and authorised account validation are recorded separately when credential-backed runs are completed.

What you can map

comments

Add task comment
Destination
Not retried automatically
Adds a comment to a task.
List task comments
Source
Comments on a task.
Edit comment
Destination
Duplicate protected
Replaces the body of a comment (v1 endpoint).

custom fields

List custom fields
Source
Custom field definitions for tasks, projects and companies.

files

List task files
Source
File metadata attached to a task (v1 endpoint); contents are not transferred.

milestones

Create milestone
Destination
Not retried automatically
Creates a milestone with a deadline and responsible users (v1 endpoint).
List milestones
Source
Incremental
Milestones across projects with deadlines, owners and linked task lists.
Update milestone
Destination
Duplicate protected
Updates supplied milestone fields (v1 endpoint).

people

List people
Source
Users on the site, for assignee mapping.

projects

Create project
Destination
Not retried automatically
Creates a project (v1 endpoint).
Get project
Source
A single project.
List projects
Source
Incremental
Projects visible to the API user, optionally updated since a time.
Update project
Destination
Duplicate protected
Updates supplied project fields (v1 endpoint).

subtasks

Create subtask
Destination
Not retried automatically
Creates a subtask under a task.
List subtasks
Source
Subtasks of a task.

task completions

Complete task
Destination
Duplicate protected
Marks a task complete (v1 endpoint).

task custom fields

Set task custom field
Destination
Not retried automatically
Adds a custom field value to a task.
List task custom field values
Source
Custom field values set on a task.
Update task custom field
Destination
Duplicate protected
Changes a custom field value on a task.

tasklists

Create task list
Destination
Not retried automatically
Creates a task list in a project, optionally linked to a milestone (v1 endpoint).
List task lists
Source
Task lists in a project with their milestone links.
Update task list
Destination
Duplicate protected
Updates a task list name, description or milestone (v1 endpoint).

tasks

Create task
Destination
Not retried automatically
Creates a task in a task list with assignees, dates, estimate and dependencies.
Get task
Source
A single task.
List tasks
Source
Incremental
Tasks across projects or task lists, ordered by last update.
Update task
Destination
Duplicate protected
Updates supplied task fields; omitted fields are unchanged.

time entries

Log time
Destination
Not retried automatically
Logs time on a task, or on a project when no task is given.
List time entries
Source
Incremental
Logged time across projects or tasks.
Update time entry
Destination
Duplicate protected
Updates supplied fields of a time entry.

Authentication

Teamwork.com API key (Basic authentication)

Plans and access

All Teamwork.com plans with API access; custom fields and time tracking depend on plan. Access follows the permissions of the user whose API key is used.

Test environment

Use a Teamwork.com trial site; there is no separate sandbox host.

Rate limits

150 requests per minute up to the Grow plan and 300 on Scale; HTTP 429 until the window resets.

Provider events

Teamwork.com webhooks for task, milestone, comment and time events. Nexra event triggers are not yet available; flows run on demand or on a schedule.

Before you build a flow

Custom domains are not supported; use the teamwork.com or eu.teamwork.com address.
Project, task list and milestone writes and comment edits use the v1 endpoints because v3 does not offer them.
The v1 task list request schema only documents task defaults; name, description and milestone-id follow the documented task list fields.
Predecessor types start and complete follow Teamwork's dependency options; the API reference does not enumerate them.
File metadata is read; file contents are not transferred.
Teamwork.com has no idempotency key; uncertain creates are not repeated automatically.