Teamwork Projects (Preview)

  • Reference

Keep all your team's tasks in one place. Collaborate and work in real time for real results. Teamwork Projects is a powerful and simple way to collaborate with your team.

This connector is available in the following products and regions:

Service Class Regions
Logic Apps Standard All Logic Apps regions except the following:
     -   Azure Government regions
     -   Azure China regions
     -   US Department of Defense (DoD)
Power Automate Premium All Power Automate regions except the following:
     -   US Government (GCC)
     -   US Government (GCC High)
     -   China Cloud operated by 21Vianet
     -   US Department of Defense (DoD)
Power Apps Premium All Power Apps regions except the following:
     -   US Government (GCC)
     -   US Government (GCC High)
     -   China Cloud operated by 21Vianet
     -   US Department of Defense (DoD)
Connector Metadata
Publisher Microsoft
Website https://www.teamwork.com/
Privacy policy https://www.teamwork.com/legal/privacy-policy/

To use the triggers in this integration, first you must have enabled Webhooks for your Teamwork Projects account. To enable Webhooks, click Settings in the top right of your Teamwork Projects account, click Site Settings and select the Webhooks tab. Once the setting is enabled in your account, using a trigger will automatically register the webhook for you.

Creating a connection

The connector supports the following authentication types:
Default Parameters for creating connection. All regions Not shareable

Default

Applicable: All regions

Parameters for creating connection.

This is not shareable connection. If the power app is shared with another user, another user will be prompted to create new connection explicitly.

Name Type Description Required
Username string The username for this api True
Password securestring The password for this api True
Site url string Root site url (Example: https://my.teamwork.com ) True

Throttling Limits

Name Calls Renewal Period
API calls per connection 100 60 seconds
Frequency of trigger polls 1 1 seconds

Actions

Create project

This operation is used to create a new Teamwork project.
Create task

This operation is used to create a new task.
Create user

This operation is used to create a new user.
Delete task

This operation is used to delete a task.
Get project

This operation returns all properties asosciated with a specific project, given its id.
Get task

This operation returns all properties asosciated with a specific task, given its id.
Get user

This operation is used to get all details of a user.
List projects

This operation returns a list of all projects associated with your account.
List tasks

This operation is used to return a list of tasks for a given project.
List users

This operation returns a list of all users asosciated with a specific project.
Update task

This operation is used to update the properties of a specific task.

Create project

Operation ID:
CreateProject

This operation is used to create a new Teamwork project.

Parameters

Name Key Required Type Description
Name
 name True string

Project name.
Description
 description string

More details about the project.
Category Id
 category-id string

Pick a category
Company Id
 companyId string

Pick an existing company.
New Company
 newCompany string

Enter the name of a new external company.
Start Date
 startDate string

yyyy-MM-dd
End Date
 endDate string

yyyy-MM-dd
Tags
 tags string

A comma separated list of tags for the project.

Returns

Body
CreateProject_Response

Create task

Operation ID:
CreateTask

This operation is used to create a new task.

Parameters

Name Key Required Type Description
Project Id
 projectId True string

Pick a project.
Task list Id
 taskListId True string

Pick a task list.
Name
 content True string

Task title.
Description
 description string

Details of the task.
Progress
 progress string

Set the progress from 0 to 90.
Assign To
 responsible-party-id string

Pick a user.
Start Date
 start-date string

yyyy-MM-dd
Due Date
 due-date string

yyyy-MM-dd
Estimated minutes
 estimated-minutes string

For a task to complete.
Priority
 priority string

Pick a priority.
Notify People
 notify boolean

True to notify people assigned to this task by email.
Is Private
 private boolean

True to make task private.
Tags
 tags string

A comma separated list of tags for the task.

Returns

Body
UpsertTask_Response

Create user

Operation ID:
CreateUser

This operation is used to create a new user.

Parameters

Name Key Required Type Description
Email Address
 email-address True string

User's email.
First Name
 first-name True string

User's first name.
Last Name
 last-name True string

User's last name.
Company Id
 company-id string

User's company.
Job Title
 title string

User's title.
Home
 phone-number-home string

User's home phone.
Mobile
 phone-number-mobile string

User's mobile phone.
Office
 phone-number-office string

User's office phone.
Office Extension
 phone-number-office-ext string

User's office phone extension.
Fax
 phone-number-fax string

User's fax number.
Username
 user-name True string

Display name of the user.

Returns

Body
CreateUser_Response

Delete task

Operation ID:
DeleteTask

This operation is used to delete a task.

Parameters

Name Key Required Type Description
Task Id
 taskId True string

Unique id of the task.

Returns

Body
DeleteTask_Response

Get project

Operation ID:
GetProject

This operation returns all properties asosciated with a specific project, given its id.

Parameters

Name Key Required Type Description
Project Id
 projectId True string

Unique id of the project.

Returns

Body
GetProject_Response

Get task

Operation ID:
GetTask

This operation returns all properties asosciated with a specific task, given its id.

Parameters

Name Key Required Type Description
Task Id
 taskId True string

Unique id of the task.

Returns

Details associated with a specific task.

Body
GetTask_Response

Get user

Operation ID:
GetUser

This operation is used to get all details of a user.

Parameters

Name Key Required Type Description
Person Id
 personId True string

Unique id of the person.

Returns

Body
GetUser_Response

List projects

Operation ID:
ListProjects

This operation returns a list of all projects associated with your account.

Returns

Body
ListProjects_Response

List tasks

Operation ID:
ListTasks

This operation is used to return a list of tasks for a given project.

Parameters

Name Key Required Type Description
Project Id
 projectId True string

Pick a project.
Task list Id
 taskListId True string

Pick a task list.

Returns

Body
ListTasks_Response

List users

Operation ID:
ListUsers

This operation returns a list of all users asosciated with a specific project.

Parameters

Name Key Required Type Description
Project Id
 projectId True string

Pick a project.

Returns

Body
ListUsers_Response

Update task

Operation ID:
UpdateTask

This operation is used to update the properties of a specific task.

Parameters

Name Key Required Type Description
Task Id
 taskId True string

Unique id of the task.
Name
 content string

Task name.
Description
 description string

Task description.
Progress
 progress string

Integer from 0 to 90.
Assign to
 responsible-party-id string

Pick a person.
Start Date
 start-date string

yyyy-MM-dd
Due Date
 due-date string

yyyy-MM-dd
Estimated time
 estimated-minutes string

Minutes to complete the task.
Priority
 priority string

Pick a priority.
Notify People
 notify boolean

True to notify people assigned to this task by email.
Is Private
 private boolean

True to make task private.
Tags
 tags string

A comma separated list of tags for the task.

Returns

Body
UpsertTask_Response

Triggers

When a project is created

This operation triggers when a new project is created.
When a task is created

This operation triggers when a new task is created.
When a user is created

This operation triggers when a new user is created.

When a project is created

Operation ID:
WebhookCreateProject

This operation triggers when a new project is created.

Returns

Body
ProjectResponse

When a task is created

Operation ID:
WebhookCreateTask

This operation triggers when a new task is created.

Returns

Body
TaskResponse

When a user is created

Operation ID:
WebhookCreateUser

This operation triggers when a new user is created.

Returns

Body
UserResponse

Definitions

ProjectResponse

Name Path Type Description
Project Id
 objectId string

Unique identifier of the project.

TaskResponse

Name Path Type Description
Task Id
 objectId string

Unique identifier of the task.

UserResponse

Name Path Type Description
User Id
 objectId string

Unique identifier of the user.

CreateProject_Response

Name Path Type Description
Project Id
 id string

Unique id of the project.

ListProjects_Response

Name Path Type Description
Projects List
 projects array of Project_Response

Array of all projects asosciated with your account.

GetProject_Response

Name Path Type Description
project
 project Project_Response

Project_Response

Name Path Type Description
Id
 category.id string

Unique id of the project category.
Name
 category.name string

Name of the project category.
Id
 company.id string

Unique id of the company.
Name
 company.name string

Name of the company.
Created Date-Time
 created-on date-time

yyyy-MM-ddTHH:mm:ss.fffZ
Description
 description string

More details about the project.
End Date-Time
 endDate string

yyyy-MM-dd
Timer Enabled
 harvest-timers-enabled boolean

True if Harvest timer is enabled.
Project Id
 id string

Unique id of the project.
Updated Date-Time
 last-changed-on date-time

yyyy-MM-ddTHH:mm:ss.fffZ
Logo
 logo string

Project logo.
Name
 name string

Project name.
Overview Page
 overview-start-page string

Url of the overview-start-page.
Privacy Enabled
 privacyEnabled boolean

True if privacy is enabled.
Starred
 starred boolean

True if project is starred.
Start Date-Time
 startDate string

yyyy-MM-dd
Start Page
 start-page string

Url of the start-page.
Status
 status string

Status of the project.
Substatus
 subStatus string

Substatus of the project.
Tasks Start Page
 tasks-start-page string

Url of the tasks-start-page.
Type
 type string

Type of project.

UpsertTask_Response

Name Path Type Description
Task Id
 id string

Unique id of the task.

ListTasks_Response

Name Path Type Description
todo-items
 todo-items array of Task_Response

List of tasks along with their properties.

GetTask_Response

Details associated with a specific task.

Name Path Type Description
todo-item
 todo-item Task_Response

Task_Response

Name Path Type Description
Can Complete
 canComplete boolean

True if the task can be completed.
Can Edit
 canEdit boolean

True if the task can be edited.
Can Log Time
 canLogTime boolean

True if time can be logged to the task.
Company Id
 company-id integer

Unique id of the company.
Company Name
 company-name string

Name of the company.
Is completed
 completed boolean

True is the task is completed.
Name
 content string

Title of the task.
Created Date-Time
 created-on date-time

yyyy-MM-ddTHH:mm:ss.fffZ
Creator Avatar URL
 creator-avatar-url string

Avatar URL of the task creator.
Creator First Name
 creator-firstname string

First name of the task creator.
Creator Id
 creator-id integer

Unique id of the creator.
Creator Last Name
 creator-lastname string

Last name of the task creator.
Description
 description string

Task description.
Due Date
 due-date string

yyyy-MM-dd
Estimated Minutes
 estimated-minutes integer

Time estimate for the task.
Harvest Enabled.
 harvest-enabled boolean

True if harvest is enabled.
Dependency Count
 has-dependencies integer

Number of dependencies the task has.
Has Predecessors
 has-predecessors integer

Number of predecessors the task has.
Has Reminders
 has-reminders boolean

True if reminders exist.
Has Tickets
 hasTickets boolean

True if tickets exist.
has-unread-comments
 has-unread-comments boolean

True if unread comments exist.
Task Id
 id integer

Unique id of the task.
Updated Date-Time
 last-changed-on date-time

yyyy-MM-ddTHH:mm:ss.fffZ
Lock Down Id
 lockdownId string

Unique Id of lock down.
Parent Task Id
 parentTaskId string

Unique Id of the parent task.
Priority
 priority string

Priority of the task.
Private
 private integer

1 if the task is private.
Progress
 progress integer

Integer between 0 and 90.
Project Id
 project-id integer

Unique Id of the project.
Project Name
 project-name string

Name of the project.
Start Date
 start-date string

yyyy-MM-dd
Status
 status string

Deleted, completed, reopened or new.
Todo List Id
 todo-list-id integer

Unique Id of the todo list.
Todo List Name
 todo-list-name string

Name of the todo list.
Following Changes
 userFollowingChanges boolean

True if user is following changes.
Following Comments
 userFollowingComments boolean

True if user is following comments.

DeleteTask_Response

Name Path Type Description
Task Id
 affectedTaskIds string

Unique id of the task.

CreateUser_Response

Name Path Type Description
User Id
 id string

Unique identifier of the user.

ListUsers_Response

Name Path Type Description
Users
 people array of User_Response

List of users.

GetUser_Response

Name Path Type Description
person
 person User_Response

User_Response

Name Path Type Description
Avatar URL
 avatar-url string

User's avatar url.
Company Id
 company-id string

Unique Id of the company.
Company Name
 company-name string

Name of the company.
Email Address
 email-address string

User's email.
Email Alternate 1
 email-alt-1 string

User's alternate email.
First Name
 first-name string

User's first name.
User Id
 id string

Unique id of the user.
Last Name
 last-name string

User's last name,
Notes
 notes string

Notes about the user.
Open Id
 openId string

User's open id.
Fax Number
 phone-number-fax string

User's fax number.
Home
 phone-number-home string

User's home phone.
Mobile
 phone-number-mobile string

User's mobile number.
Country Code
 phone-number-mobile-parts.countryCode string

User's mobile number.
Phone
 phone-number-mobile-parts.phone string

User's mobile number.
Prefix
 phone-number-mobile-parts.prefix string

User's mobile number.
Office
 phone-number-office string

User's office phone number.
Office Extension
 phone-number-office-ext string

User's office phone number.
Pid
 pid string

User's pid.
Title
 title string

User's title.
Twitter
 twitter string

User's twitter handle.
Username
 user-name string

Display name of the user.
Type
 user-type string

User type.
UUID
 userUUID string

User's UUID.