> ## Documentation Index
> Fetch the complete documentation index at: https://docs.withampersand.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Teamwork

## What's Supported

### Supported Actions

This connector supports:

* [Write Actions](/write-actions).
* [Read Actions](/read-actions), including full historic backfill and incremental read.
* [Proxy Actions](/proxy-actions), using the base URL `https://{{.workspace}}.teamwork.com`.

### Supported Objects

The Teamwork connector supports reading from and writing to the following objects:

* [categories](https://apidocs.teamwork.com/docs/teamwork/v3/categories/get-projects-api-v3-projects-teamwork-categories-json)
* [comments](https://apidocs.teamwork.com/docs/teamwork/v3/comments/get-projects-api-v3-comments-json)
* [companies](https://apidocs.teamwork.com/docs/teamwork/v3/companies/get-projects-api-v3-companies-json)
* [dashboards](https://apidocs.teamwork.com/docs/teamwork/v3/dashboards/get-projects-api-v3-dashboards-json)
* [forms](https://apidocs.teamwork.com/docs/teamwork/v3/forms/get-projects-api-v3-forms-json)
* [jobroles](https://apidocs.teamwork.com/docs/teamwork/v3/job-roles/get-projects-api-v3-jobroles-json)
* [me/timers](https://apidocs.teamwork.com/docs/teamwork/v3/time-tracking/get-projects-api-v3-me-timers-json)
* [messages](https://apidocs.teamwork.com/docs/teamwork/v3/messages/get-projects-api-v3-messages-json)
* [milestones](https://apidocs.teamwork.com/docs/teamwork/v3/milestones/get-projects-api-v3-milestones-json)
* [notebooks](https://apidocs.teamwork.com/docs/teamwork/v3/notebooks/get-projects-api-v3-notebooks-json)
* [people](https://apidocs.teamwork.com/docs/teamwork/v3/people/get-projects-api-v3-people-json)
* [projects](https://apidocs.teamwork.com/docs/teamwork/v3/projects/get-projects-api-v3-projects-json)
* [tags](https://apidocs.teamwork.com/docs/teamwork/v3/tags/get-projects-api-v3-tags-json)
* [tasklists](https://apidocs.teamwork.com/docs/teamwork/v3/task-lists/get-projects-api-v3-tasklists)
* [tasks](https://apidocs.teamwork.com/docs/teamwork/v3/tasks/get-projects-api-v3-tasks-json)
* [time](https://apidocs.teamwork.com/docs/teamwork/v3/time-tracking/get-projects-api-v3-time-json)
* [timers](https://apidocs.teamwork.com/docs/teamwork/v3/time-tracking/get-projects-api-v3-timers-json)
* [timesheets](https://apidocs.teamwork.com/docs/teamwork/v3/timesheets/get-projects-api-v3-timesheets-json)
* [updates](https://apidocs.teamwork.com/docs/teamwork/v3/project-updates/get-projects-api-v3-projects-updates-json)

## Before You Get Started

To connect Teamwork with Ampersand, you will need a [Teamwork Account](https://www.teamwork.com/signup/).

Once your account is created, you'll need to configure an app in Teamwork and obtain the following credentials from your app:

* Client ID
* Client Secret

You will use these credentials to connect your application to Ampersand.

### Create a Teamwork Account

Here's how you can sign up for a Teamwork account:

1. Go to the [Teamwork Sign Up page](https://www.teamwork.com/signup/).
2. Sign up using your preferred method.

### Creating a Teamwork App

Follow the steps below to create a Teamwork app and add the Ampersand redirect URL:

1. Log in to the [Teamwork Developer Portal](https://www.teamwork.com/launchpad/login/developer/).

2. Click on **Create New App**.

3. Enter App Details:
   * **App Name:** Enter a descriptive name for your application.
   * **Description:** Provide a brief description of what your app does.
   * **Redirect URI:** Enter the Ampersand redirect URL: `https://api.withampersand.com/callbacks/v1/oauth`

4. Click **Create App**.

Once your app is created, you can click on the app and go to the **Credentials** tab to get **Client ID** and **Client Secret** for your app.

**Note:** Make sure to securely note down the **Client ID** and **Client Secret** as you will need these credentials to connect your app to Ampersand.

<img src="https://mintcdn.com/ampersand-24eb5c1a/Bx3tggG51e0liOp-/images/provider-guides/62552cd-teamwork1.gif?s=09392cf26287670c71b42f1be5fea942" alt="Teamwork App Credentials" width="1680" height="820" data-path="images/provider-guides/62552cd-teamwork1.gif" />

### Add Your Teamwork App Info to Ampersand

1. Log in to your [Ampersand Dashboard](https://dashboard.withampersand.com).

2. Select the project where you want to create a *Teamwork* integration.

   <img src="https://mintcdn.com/ampersand-24eb5c1a/CkzFg-K1u4gYx3ZD/images/provider-guides/dd47b7a-Ampersand.png?fit=max&auto=format&n=CkzFg-K1u4gYx3ZD&q=85&s=d580aa00cc421fe14cfbab79c2e0812f" alt="Ampersand Project" width="2244" height="442" data-path="images/provider-guides/dd47b7a-Ampersand.png" />

3. Select **Provider apps**.

4. Select *Teamwork* from the **Provider** list.

5. Enter the previously obtained **Client ID** and **Client Secret** in the respective fields.

   <img src="https://mintcdn.com/ampersand-24eb5c1a/Bx3tggG51e0liOp-/images/provider-guides/57fdc27-teamwork2.gif?s=35ecd4ceb43b7b7e02108962fc727f15" alt="Ampersand Constant Contact Integration" width="822" height="528" data-path="images/provider-guides/57fdc27-teamwork2.gif" />

6. Click **Save Changes**.