For the complete documentation index, see llms.txt. This page is also available as Markdown.

Teamwork

Teamwork is a project management platform for projects, tasks, comments, and team collaboration workflows.

Connectors

Choose the connector that matches your authentication method. The options below use the names shown in StackAI.

Connector
Authentication

Teamwork

Credentials

Teamwork

Connect to Teamwork with a site subdomain and API token.

Set up in Teamwork

  1. Sign in to your Teamwork site and note your site subdomain (the yoursite part of yoursite.teamwork.com).

  2. Open your profile and go to Edit My Details then the API & Mobile section to view or generate your API token (API key).

  3. Copy the API token.

Set up in StackAI

  1. Open Settings → Connections, add a connection, and select Teamwork.

  2. Enter the credentials and connection details in the fields below.

  3. Save the connection and check its connection status. Select this saved connection when configuring an action or feature that uses it.

Connection fields

StackAI field
Required
What to enter

Site

Yes

Your Teamwork site subdomain from https://<site>.teamwork.com.

API Token

Yes

Your Teamwork API token. Provider instructions.

Provider documentation: Setup reference.

Verify the connection

Check that the connection is healthy. Then run a read operation against a resource the connected account can access. A successful connection check confirms authentication; it does not guarantee permission for every action.

If access is denied, check the credential or OAuth permissions, the selected account or environment, and access to the specific resource. Update expired credentials or reconnect after permissions change.

Use an action

  1. Add the required Teamwork action to the workflow.

  2. Select a connection when the action requests one.

  3. Complete the required fields. Use the reference picker when a value comes from another workflow step.

  4. Run the workflow and inspect the action’s output. Check the result before using it in a later step.

Actions

Create Project

Create a new Teamwork project.

Inputs

Field
Type
Required
Description

Project Name

string

Yes

Project name.

Description

textarea

No

Optional project description.

Company ID

integer

No

Optional Teamwork company ID.

Start Date

string

No

Optional project start date.

End Date

string

No

Optional project end date.

Outputs

Field
Type
Description

Project ID

integer

Created Teamwork project ID.

Project

dict

Created Teamwork project object.

List Tasks

List Teamwork tasks across projects.

Inputs

Field
Type
Required
Description

Page

integer

No

Page number. Default: 1.

Page Size

integer

No

Number of tasks to return. Default: 50.

Search Term

string

No

Optional task search term.

Task Filter

select (string)

No

Optional Teamwork task filter. Available values: All, Anytime, Completed, Created, Overdue, Today, Yesterday, Started, Tomorrow, This Week, Within 7, Within 14, Within 30, Within 365, No Date, No Due Date, No Start Date, Has Date.

Order Mode

select (string)

No

Optional sort direction. Available values: Asc, Desc.

Order By

string

No

Optional Teamwork order field.

Project IDs

array

No

Optional project IDs to filter by.

Task List IDs

array

No

Optional task list IDs to filter by.

Status

array

No

Optional task status filters.

Include Completed

boolean

No

Include completed tasks.

Outputs

Field
Type
Description

Tasks

dict_array

Returned Teamwork tasks.

Count

integer

Number of tasks returned.

Has More

boolean

Whether Teamwork has more results.

Create Task

Create a new task in a Teamwork task list.

Inputs

Field
Type
Required
Description

Task List ID

integer

Yes

Teamwork task list ID where the task will be created.

Task Name

string

Yes

Task name.

Description

textarea

No

Optional task description.

Start Date

string

No

Optional task start date.

Due Date

string

No

Optional task due date.

Priority

select (string)

No

Optional task priority. Available values: None, Low, Medium, High.

Progress

integer

No

Optional progress percentage.

Assignee User IDs

array

No

Optional Teamwork user IDs to assign.

Tag IDs

array

No

Optional Teamwork tag IDs.

Notify

boolean

No

Notify assignees/followers when Teamwork supports it.

Private

boolean

No

Create the task as private.

Fire Webhook

boolean

No

Whether Teamwork should fire webhooks for this request.

Outputs

Field
Type
Description

Task ID

integer

Created Teamwork task ID.

Task

dict

Created Teamwork task object.

Update Task

Update an existing Teamwork task.

Inputs

Field
Type
Required
Description

Task ID

integer

Yes

Teamwork task ID to update.

Task Name

string

No

Optional new task name.

Description

textarea

No

Optional new task description.

Start Date

string

No

Optional start date.

Due Date

string

No

Optional due date.

Priority

select (string)

No

Optional priority. Available values: None, Low, Medium, High.

Progress

integer

No

Optional progress percentage.

Status

string

No

Optional Teamwork task status.

Assignee User IDs

array

No

Optional Teamwork user IDs to assign.

Tag IDs

array

No

Optional Teamwork tag IDs.

Private

boolean

No

Whether the task should be private.

Fire Webhook

boolean

No

Whether Teamwork should fire webhooks for this request.

Outputs

Field
Type
Description

Task ID

integer

Updated Teamwork task ID.

Task

dict

Updated Teamwork task object.

Add Comment

Add a comment to a Teamwork task.

Inputs

Field
Type
Required
Description

Task ID

integer

Yes

Teamwork task ID to comment on.

Comment

textarea

Yes

Comment body.

Content Type

string

No

Optional Teamwork comment content type. Default: TEXT.

Private

boolean

No

Create a private comment.

Notify

string

No

Optional Teamwork notification target.

Outputs

Field
Type
Description

Comment ID

integer

Created Teamwork comment ID.

Comment

dict

Created Teamwork comment object.

Important behavior

Actions that create, update, send, or delete data can change the connected service. Review their inputs before running them. A retry can repeat an operation; consider this when configuring retries for actions that change data.

The catalog lists the fields and capabilities available in the supplied provider definition. Availability can also depend on your deployment and organization’s Feature Access settings.

Last updated

Was this helpful?