Teamwork.com
Turn requests and orders into Teamwork.com work, and keep status in step across your tools.
35 ways to read, 24 ways to write, each write switched on by you.
Quality checks
Built and tested with example responses.
- Ready to connect: doneEvery listed action is built in.
- Built and tested with example responses: doneEach action is built from the provider’s published API and tested against example responses, errors, rate limits and paging.
Connected, approved, proven.
The things teams do most with Teamwork.com, an example flow with a person in the loop, and what Nexra keeps as proof.
Top actions
- Add task commentApproval by rule
- Create companyApproval by rule
- List latest activityRead
Example flow
- Teamwork.com · List latest activityDone
- Teamwork.com · Add task commentNeeds approval
- Nexra · Record the decision and result in the evidence chainProven
Example workflow. Routine runs go through on their own. Only a change your rules flag, such as one over a limit you set, waits for the right person, who sees the exact change and the rule before it reaches Teamwork.com.
What gets logged
- Whether it ran on its own or who approved it, and under which rule
- A fingerprint of the exact request sent to Teamwork.com
- Teamwork.com's reply: what it created or changed
- One entry in the evidence chain, linked to the one before
Try this in the sandbox
Run the whole flow with test data in your sandbox, then connect your own account when you are ready to go live.
For developers
Technical detail
Read and write Teamwork.com projects, tasks, milestones, time, comments, companies, tags, notebooks and custom fields; read people, messages, activity and project updates.
Teamwork.com API docs- Source actions
- 35
- Destination actions
- 24
- Data types
- 22
What you can map
Reads are always available. Writes are off until you switch them on for a connection, and governed writes follow your policies.
Activity1
- List latest activitySourceIncremental
The site activity feed (created, edited, completed and deleted items) across projects, optionally since a time.
Comments5
- Add task commentDestinationNot retried automaticallyApproval before production
Adds a comment to a task.
- Get commentSource
A single comment on any item.
- List task commentsSource
Comments on a task.
- Search commentsSourceIncremental
Comments across projects on tasks, milestones, notebooks, files and links, optionally matching text or updated since a time.
- Edit commentDestinationProvider duplicate protectionApproval before production
Replaces the body of a comment (v1 endpoint).
Companies4
- Create companyDestinationNot retried automaticallyApproval before production
Creates a client company with contact details and address.
- Get companySource
A single company.
- List companiesSourceIncremental
Client and owner companies, optionally matching text or updated since a time.
- Update companyDestinationProvider duplicate protectionApproval before production
Updates supplied company fields; omitted fields are unchanged.
Custom fields2
- Get custom fieldSource
A custom field definition with its options.
- List custom fieldsSource
Custom field definitions for tasks, projects and companies.
Files1
- List task filesSource
File metadata attached to a task (v1 endpoint); contents are not transferred.
Messages2
- Get messageSource
A single message board post.
- List messagesSourceIncremental
Project message board posts, optionally updated since a time.
Milestones4
- Create milestoneDestinationNot retried automaticallyApproval before production
Creates a milestone with a deadline and responsible users (v1 endpoint).
- Get milestoneSource
A single milestone.
- List milestonesSourceIncremental
Milestones across projects with deadlines, owners and linked task lists.
- Update milestoneDestinationProvider duplicate protectionApproval before production
Updates supplied milestone fields (v1 endpoint).
Notebooks4
- Create notebookDestinationNot retried automaticallyApproval before production
Creates a Markdown or HTML notebook in a project without notifying anyone.
- Get notebookSource
A notebook with its contents.
- List notebooksSourceIncremental
Project notebooks (documents), optionally with contents and updated since a time.
- Update notebookDestinationProvider duplicate protectionApproval before production
Updates a notebook's name, contents, format or category.
People2
- Get personSource
A single user.
- List peopleSource
Users on the site, for assignee mapping.
Project categories2
- Get project categorySource
A single project category.
- List project categoriesSource
Project categories and their parents.
Project custom fields3
- Set project custom fieldDestinationNot retried automaticallyApproval before production
Adds a custom field value to a project.
- List project custom field valuesSource
Custom field values set on a project.
- Update project custom fieldDestinationProvider duplicate protectionApproval before production
Changes a custom field value on a project.
Project people1
- List project peopleSource
Users on a project, for assignee mapping within that project.
Project updates1
- List project updatesSourceIncremental
Project status updates with health, optionally updated since a time.
Projects4
- Create projectDestinationNot retried automaticallyApproval before production
Creates a project (v1 endpoint).
- Get projectSource
A single project.
- List projectsSourceIncremental
Projects visible to the API user, optionally updated since a time.
- Update projectDestinationProvider duplicate protectionApproval before production
Updates supplied project fields (v1 endpoint).
Subtasks2
- Create subtaskDestinationNot retried automaticallyApproval before production
Creates a subtask under a task.
- List subtasksSource
Subtasks of a task.
Tags4
- Create tagDestinationNot retried automaticallyApproval before production
Creates a site-wide tag, or a tag limited to one project.
- Get tagSource
A single tag.
- List tagsSourceIncremental
Site and project tags, optionally matching text or updated since a time.
- Update tagDestinationProvider duplicate protectionApproval before production
Renames or recolours a tag.
Task completions1
- Complete taskDestinationProvider duplicate protectionApproval before production
Marks a task complete (v1 endpoint).
Task custom fields3
- Set task custom fieldDestinationNot retried automaticallyApproval before production
Adds a custom field value to a task.
- List task custom field valuesSource
Custom field values set on a task.
- Update task custom fieldDestinationProvider duplicate protectionApproval before production
Changes a custom field value on a task.
Tasklists4
- Create task listDestinationNot retried automaticallyApproval before production
Creates a task list in a project, optionally linked to a milestone (v1 endpoint).
- Get task listSource
A single task list.
- List task listsSource
Task lists in a project with their milestone links.
- Update task listDestinationProvider duplicate protectionApproval before production
Updates a task list name, description or milestone (v1 endpoint).
Tasks4
- Create taskDestinationNot retried automaticallyApproval before production
Creates a task in a task list with assignees, dates, estimate and dependencies.
- Get taskSource
A single task.
- List tasksSourceIncremental
Tasks across projects or task lists, ordered by last update.
- Update taskDestinationProvider duplicate protectionApproval before production
Updates supplied task fields; omitted fields are unchanged.
Time entries4
- Log timeDestinationNot retried automaticallyApproval before production
Logs time on a task, or on a project when no task is given.
- Get time entrySource
A single time entry.
- List time entriesSourceIncremental
Logged time across projects or tasks.
- Update time entryDestinationProvider duplicate protectionApproval before production
Updates supplied fields of a time entry.
Timers1
- List running timersSource
Timers that users are running, for live time tracking.
Access and limits
- 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.
- Pagination
- page and pageSize with meta.page.hasMore on v3 list endpoints.
- Provider events
- Teamwork.com webhooks for task, milestone, comment and time events. Flows run on demand, on a schedule, or when a scheduled check finds new or changed records.
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.
- Company custom fields, logos and client portal links are not written; company and project custom field values are read with their definitions.
- Notebook writes never send notifications; notebook tags, privacy lists and locking are not changed.
- Messages are read only: posting a message notifies project members, so Nexra does not create or edit them.
- Intentionally excluded: every delete and bulk delete, project, task and company trashing, adding or removing people from projects, user creation and invitations, permission and role changes, job roles and skills assignments, reminders (they notify people), timer start/stop, time approval reopen, invoices, expenses, quotes and budgets.
Developer reference
- Create the Teamwork.com credentials described above with the narrowest permissions your flows need.
- In Nexra, open Connect, then Connections, then New connection, choose Teamwork.com, enter its settings and credentials, and tick only the write actions you need. Connection guide
- Test the connection, then use its actions as flow sources and destinations. Flow guide
Machine-readable detail: GET /api/public/connect/connectors/teamwork and the Connections API.