> For the complete documentation index, see [llms.txt](https://daton-sarasanalytics.gitbook.io/daton/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://daton-sarasanalytics.gitbook.io/daton/integrations/data-sources/business/teamwork/how-to-integrate-teamwork-with-daton.md).

# How to Integrate Teamwork with Daton

### Pre-requisites

Before starting, ensure you have 

* An active Teamwork and Daton account.
* Teamwork Site URL and API Key.

### Task 1**: Get your** Teamwork Site URL and API Key

#### Get Your Teamwork Site URL :

Perform the following steps to get your Teamwork Site URL:  

1. Log in to your Teamwork account and click your **Avatar** in the bottom left.
2. From the menu that appears, select **Settings**.
3. Once you are in the settings section, locate and click on **General**.
4. Your **Site Address** will be visible in this section. 

   <figure><img src="/files/8QCgAWFIX6vNDi55waV2" alt=""><figcaption></figcaption></figure>

   Copy and save this URL as it will be used during the integration.

#### **Get Your** Teamwork API Key

Perform the following steps to get your Teamwork API Key: &#x20;

1. Log in to your Teamwork account and click your **Avatar** in the bottom left.
2. From the menu that appears, select **Edit My Details**.
3. Navigate to the **API & Mobile** tab.
4. Locate the **Your API token** section and click the **Show your token** button to reveal your API token.&#x20;

   <figure><img src="/files/NgYtzCNcTgq4yvlLpsU4" alt=""><figcaption></figcaption></figure>

   You can use the API key to authenticate Teamwork API requests.&#x20;

For more information, see [Teamwork- API Key & URL](https://apidocs.teamwork.com/docs/teamwork/d1b2de52c3cec-api-key-and-url).&#x20;

### Task &#x32;**:** Integrate Daton with Teamwork

1. Log in to your [Daton account](https://daton.sarasanalytics.com/u/integrations-list) and search for Teamwork in the list of Connectors, then click **Configure**.
2. Enter or select the following details and click **Authenticate**:&#x20;

   * Integration Name. Note that the Integration Name will be used to create the integration tables and cannot be modified later.
     * Optionally, add a description to identify the integration.
   * Replication Frequency&#x20;
   * Replication Start Date
   * Optionally, expand the **Advanced Configuration Options** section and, based on your requirements, modify the options to control the loading behavior of Daton.

   <figure><img src="/files/lfZeW0wZH1eguINEXJw9" alt=""><figcaption></figcaption></figure>
3. Paste the following in the required fields to authenticate the integration. Then click **Authenticate**.&#x20;

   1. Teamwork Site URL&#x20;
   2. Teamwork API Key

   <figure><img src="/files/MSXH1YneHzPbUa3ElH8e" alt=""><figcaption></figcaption></figure>
4. After successful authentication, you will be prompted to choose from the list of available tables. Select the required tables and click **Next**.&#x20;

   * Based on your requirement, select specific options for each selected table.

   <figure><img src="/files/uvtMXJDaUtb7BUYjgV9K" alt=""><figcaption></figcaption></figure>
5. Select the required fields for each table and click **Submit.**&#x20;

   <figure><img src="/files/g4UP2E1GKV3HFigaM1eM" alt=""><figcaption></figcaption></figure>

   * **Note** that you will be prompted to select the destination for your account.
6. Select the destination for extracting Teamwork data for replication and click **Confirm**. An integration successful message will be displayed.

## Important Note

* Integrations would begin in the Pending state and change to the Active state once the first job successfully loaded data into the configured warehouse.&#x20;
* Users can check job status and process logs from the integration details page by clicking on the integration name in the active list.&#x20;
* Users can Re-Authenticate, Edit, Clone, Pause, or Delete the integration at any moment by clicking on settings. You can also adjust the frequency and history of the integration.&#x20;
* On the Sources page, click Integration to access each table in your integration. The page also shows the state of each table, the last replicated time, and the Reload access buttons.&#x20;