Toggl Integration
Table of Contents
Note: This document has been imported from the former KB and has not yet been verified.
We have integrated with the coolest time tracking app out there!
What it does
- Record time entries in Toggl on their website or mobile app.
- Import those time entries into Syncro tickets.
What it doesn't do
- This integration only supports one Toggl account per Syncro site. Users each having their own Toggl integrations isn't supported.
Set up
Check out Toggl Track—they have a free level that works great.
- Log in to your Toggl account.
- In the lower left, click your name > Profile settings.
- Scroll down to the API Token section.
- Click the - Click to reveal - gray field.
- Copy the API token that appears.
- Switch to Syncro and navigate to Admin > App Center.
- Click the Toggl app card.
- In the Toggl API Token field, paste the API token you copied.
- Click Save.
- Navigate to Admin > Tickets - Preferences.
- Check the Enable Ticket Time Tracking module box if it isn't already.
- Click Save if you changed it.
That's all for configuration!
Track time in Toggl
Now when a Ticket is created in Syncro it will create a project in Toggl with the ticket number and customer's name.
Use Timer in the left nav (https://track.toggl.com/timer) or use the Toggl mobile app to add time entries.
Add time entries to ticket
Note: To be able to adjust the labor rate you will need items in your inventory that have "Labor" or "Labour" as their category. You can add the Labor (or Labour) category in Admin > Inventory - Preferences.
- In Syncro, open the ticket.
- In the LABOR LOG section, click Toggl Import.
- A confirmation dialog will say, "Time Entries loaded successfully - view the log to see them." Click Close.
- Click View Log to see the entries.
- If you are ready, click Charge Time by the entries to get them ready to be invoiced.
- In the upper right, click the X to close the window and proceed with your ticket and invoicing as normal.
Archive Toggl entries
After you invoice and ticket and resolve it, you may want to archive the project in Toggl.
- In the left Toggl nav, click Projects.
- To the right of the desired ticket, click the three vertical dots > Archive.