Step 1 -- Find your Teamwork URL and API Access Key


Log onto Teamwork web site with your account. Copy the Teamwork URL from address. In the following example, it is https://skysheng.teamwork.com (Figure 1).



Figure 1


Click and open your account menu and click “Edit my details” (Figure 2).


Figure 2



Open My account details dialog and switch to API&Mobile tab page, then click “Get API token” for Your API token section (Figure 3)



 Figure 3


Pop up dialog named with Turn On API Access for My Account, and check I have read and agree to the API terms and conditions, click I agree, turn the API on button (Figure 4)

 Figure 4


Click Show your token and copy token Your API token section (Figure 5)



Figure 5



Step 2 -- Enter your Teamwork URL and API access key in Worksnaps

 

In Worksnaps, go to Profile & Settings >> 3rd-Party Integration >> Teamwork, enter the Teamwork URL and API access key (Figure 6).







  Figure 6


Then click Start Test button to test the connection (Figure 7).


Figure 7



If you are successfully authenticated on the Teamwork site, the following message will be seen. Make sure that you save the configuration (Figure 8).


Figure 8


Step 3 -- Sync Projects and Tasks from Teamwork


Once you have set the Teamwork URL and API access key and verified that the connection is okay, you can click the link at the bottom of the page to sync projects and tasks with Teamwork (Figure 9).



Figure 9


 

A wizard will guide you through the process to import projects and tasks from Teamwork (Figure 10).



 Figure 10


Choose a project which you want to import from Teamwork to Worksnaps (Figure 11).


Figure 11


 

Once a project is selected, all the tasks assigned to you in the project will be imported to Worksnaps (Figure 12).


Figure 12


 

Step 4 – Turn on the Time Sync (optional)

 

You only need to perform this step if you want the time logged in Worksnaps to be sync'ed to Teamwork. 


The feature of the time sync is turn off default, if you want to sync the time automatically, you can turn on this option by clicking "click here" link to sync time to Teamwork (Figure 13).


Figure 13



Choose Yes on “Set up time sync with Teamwork” dialog and click Confirm button (Figure 14).



Figure 14


 

Click Confirm button on the Confirmation dialog (Figure 15).


Figure 15


 

You will see the message “The configuration for syncing time with teamwork has been saved successfully”  (Figure 16).


Figure 16

 

 

Once you have set up the time sync to Teamwork, your logged time will be automatically sync'ed to Teamwork.

Please note that the time sync is executed periodically by the scheduled job on the server, so do expect a delay of few hours in general before you see the time in Teamwork.