Toggl Help & Support

What Toggl Triggers and Actions Are Supported?

Supported Triggers#

  • New Project - Triggers when new projects are added.
  • New Client - Triggers when a new client is created.
  • New Time Entry - Triggers when a new time entry is added.
  • New Workspace - Triggers when a new workspace is created.
  • New Time Entry Started - Triggers when a new time entry is started and running.
  • New Tag - Triggers when new tags are created.
  • New Task - Triggers when new tasks are added.

Supported Actions#

  • Create Task - Creates a new task.
  • Create Client - Creates a new client.
  • Create Project - Creates a new project.
  • Stop Time Entry - Stops an existing time entry.
  • Create Tag - Creates a new tag.
  • Create Time Entry - Creates a new time entry.
  • Start Time Entry - Starts a new time entry.

Supported Searches#

  • Find Project - Finds a project by name.
  • Find Time Entry - Finds a time entry by description.
  • Find Client - Finds a client by name.
  • Find Tag - Finds a tag by name.
  • Find Task - Finds a task by name.
Was this content helpful?

How to Get Started with Toggl

About Toggl#

  • Admin/owner permissions: The New Time Entry trigger is only able to pull in Time Entries from the authenticated user - not all users in that Toggl account.
  • Paid/versioned account: You must be on the Pro plan in order to use Toggl with Zapier.
  • Partner’s Documentation

Getting Started with Toggl#

To get started with Toggl, first click to add a Toggl account in your zap.

Connect Toggl to Zapier

Then, you'll need to name your Toggl Account on Zapier and provide your Toggl API Key.

The name field is only for identifying your Toggl Account inside Zapier. It can be whatever you want. This is helpful if you need to connect multiple Toggl accounts to Zapier.

You can find your Toggl API key by navigating to the bottom of your Toggl profile page.

Name Toggl Account and API Key

Toggl API Key in Toggl

Finally, click continue and you'll have your Toggl account connected to Zapier.

Success connecting Toggl

Was this content helpful?

Common Problems with Toggl

(500) Internal Server Error#

Toggl actions return a 500 error for any failed Task. One common reason is that the Start field when the template for "create time entry" action isn't getting a date/time field. The correct version should look something like this:

Toggl Time Entry

Can't Add Tasks to Workspace Error#

Toggl only permits the use of the Tasks portions of their API to users on their Pro plan. If you are seeing this error, this likely means you'll need to upgrade to a paid Toggle plan to be able to access these features. Once upgraded, you should no longer have any issues adding tasks.

My entries are being added for the wrong dates!#

Toggl requires that date/time entries be submitted in ISO 8601 format, which is YYYY-MM-DD. If your trigger app provides the date in another format, Toggl will try to interpret it. However, if there's ambiguity in how the date could be interpreted (for example, if the date January 9 is written as 09/01, Toggl will default to ISO 8601 and insert the entry on September 1.

To get around this, try entering the date/time in your Trigger in MM/DD format. Or, if you're not able to control the way the Trigger provides that data, use a Formatter by Zapier step to re-format the date into YYYY-MM-DD.

Was this content helpful?

Need More Help? - Our support team is happy to help -- send us a message

One of the simplest ways to keep track of your time.

Learn More

Getting Started with Zapier

Need more help? Try the Zapier Help Center