This announcement concerns people who:

  • are Toggl users but use some custom tool (not developed by Toggl) for getting, inserting or updating Toggl data
  • are using Toggl Desktop version smaller than 5.0 or Toggl mobile app version smaller than 6.0.0
  • have created a custom application, tool, script or integratioon using the Toggl API

As announced in March the old Toggl public API v6 will be retiring on September 1st and is replaced by API v8. We hope that everyone has had the time to update their code and applications from using Toggl API v6 to v8, because starting from September 1st the api/v6 requests will be returning an error as status code and the applications will not work any more. You can find the new API v8 documentation in Github.

If you use a custom tool for Toggl

You should find out who has created the tool/application/integration and ask if the code has been updated to using Toggl API v8. If the developer has no idea what you are talking about, send them the link to this blog post.

If you use an old Toggl application

As mentioned above, the Toggl supports only Toggl Desktop version 5 and higher and Toggl mobile version 6 and higher. If you have and old version please upgrade immediately. The download links and more information about desktop application can be found on our Support Center here and on mobile versions here.

If you created a custom tool using API v6

We really hope that you have already updated your code to using API v8. If not it is now the high time to do so. Note that the new API v8 is not quite the same as v6. The urls, attribute names and authentication are some of the things that have changed, so the upgrading may not be so smooth. The new API v8 documentation can be found in Github. If you have any questions, problems or requests regarding the new API, please contact us on our Github Issues page.