Connecting to Toggl

To set up Magic Suite apps to connect to your Toggl system, follow these instructions.

In Toggl

  1. In Toggl, in the top left corner, click the drop down arrow next to the name of your workspace.
  2. In the dialog box that appears, click the Workspace whose ID you wish to find.
  3. View the URL - it will be similar to: https://track.toggl.com/organization/1234567/workspaces/1111111/settings/general
    The Workspace ID is the last number. So, highlighted in bold in this example the Workspace ID is 1111111. 
  4. Note down the Workspace ID.
  5. Also in Toggl, obtain your API token as follows:
    • In the Toggl website, at the bottom left, click your profile then click Profile Settings.
    • Scroll to the bottom of the page and copy the API Token shown.

In ReportMagic

  1. From the Admin menu, click Connections.
  2. Enter a name and optionally a description.
  3. In the URL field, enter https://api.track.toggl.com/api/v9
    Note: As of May 2024, Toggl no longer supports its v8 API so Toggl macros have been updated to reflect this.
  4. In the Username field, enter your Toggl API Token.
  5. In the Password field, also enter your Toggl API Token. 
  6. Optionally, in the Configuration field, paste the default Toggl Workspace ID in JSON format (name and value pairs) replacing the number shown with your real Workspace ID:
    {
     "DefaultWorkspaceId" : 1234567 
    }
    Note: If you leave this blank, then you must set it either in the Macro Defaults or in the Toggl macros that require it. See below.
  7. Click Save.

About Setting the Toggl Workspace ID 

The workspaceId parameter in many Toggl macros is an integer required by the Toggl v9 API.
To avoid macro errors, you must set this macro parameter in one of the following:

  1. In the macro itself, for example, [Toggl.UserList: workspaceId=1234567, ...] - this takes precedence over the other two ways. 
  2. In the Macro Defaults - this takes precedence over any value set in the Toggl Connection's Configuration box.
  3. In the Configuration section of the Toggl Connection (as shown above) - when it has not been set in either previously described place.
An unhandled error has occurred. Reload 🗙