Connect to Toggl Track
To connect Exist Integrations to Toggl Track, you will need to get your API Token. In Toggl Track click on your profile and then Profile Settings. On that page you will need to copy the API Token.
From the Exist Integrations home press the + Add New Integration button. Scroll down to Toggl Track, paste your API Token, and press the Connect to Toggl Track button. You will be directed to the Manage page.
Manage Toggl Track Settings
After you have connected to Toggl Track, you must set the configure each Project to one of the Exist attributes.
Attributes
- Watching TV * - the total time watching television shows will be sent to the official watching TV attribute
- Watching Movies * - the total time watching movies will be sent to a custom attribute in Exist
- Time gaming - the total time playing games will be sent to the official time gaming attribute
- Productive time - the total time you were productive will be sent to the official productive time attribute
- Neutral time - the total time you were neutral will be sent to the official neutral time attribute
- Distracting time - the total time you were distracted will be sent to the official distracting time attribute
* These attributes are also supported with Trakt. If you have configured them with Trakt, you will not be able to configure them with Toggl Track.
Configure the attributes you wish to send to Exist and press the Set the Attributes from Toggl Track to send to Exist button.
Correct Data Issues
If you are experiencing data issues with the data Exist Integrations is sending to Exist, you can initiative a 'Zero Out.' This will zero out all attributes for the last 14 days. Then it will reprocess all pulses.
This can happen if a time entry is deleted or if you manually adjust the totals of the custom attributes from the Exist web or mobile apps.
Processor
The Toggl Track Processor runs every hour at 40 minutes past the hour. It will execute the following sequence:
- Download all time entries from Toggl Track for the projects linked to an attribute for the last 14 days
- If no records are in the user_data, save the value for the attribute
- If a record does exist, check if the date has changed. If the date has changed, send a negative value for the previous day and a positive value for the new day
- If a record does exist, and the value has changed, save a value that is the difference between what Exist Integrations has sent and what the value is from Toggl Track
- Increment any of the new data in Exist
- Purge any data linked to your Toggl Track user over than 21 days.
Note: The Exist API currently doesn't allow negative values to be sent with the increment endpoint for time entries. If you are impacted, use the Zero Out functionality until Exist updates the API or Exist Integrations handles this use case.
Disconnect
You can remove all data from Exist Integrations by disconnecting the service through the Management page. Exist Integrations will also disconnect the service if the service returns a 401 Unauthorized from the API.