> Markdown versions of all pages of this connector library are available by appending `.md` to the page URL. For the full index of connectors, see [llms.txt](https://connectors.appmixer.com/llms.txt).

# Toggl connector

- Connector: `appmixer.toggl`
- Version: 1.0.0
- Components: 16 (3 triggers, 13 actions)

Toggl is a time-tracking and work-planning tool. Teams track time entries against projects, clients, tasks and tags, then report on the hours.

- Connector page: <https://connectors.appmixer.com/connector/appmixer.toggl/1.0.0>
- Documentation: <https://docs.appmixer.com/connector-configuration/toggl>
- Source code: <https://github.com/clientIO/appmixer-connectors/tree/dev/src/appmixer/toggl>
- Download package: <https://connectors.appmixer.com/connector/appmixer.toggl/1.0.0/download>

## Authentication

**Type:** API Key

**Fields:**

- `API Token` (password): In Toggl, click your profile icon > Profile settings, scroll to API token, pick an expiration and generate the token. Copy it right away: it starts with "toggl_sk_" and is shown only once. Generating a new token revokes the previous one. API tokens of the legacy Toggl Track do not work.
- `Organization ID` (text): Optional. Leave empty, together with Workspace ID, to use your default workspace. To work in another workspace, fill in both: they are the two numbers in the Toggl URL, focus.toggl.com//workspaces//...
- `Workspace ID` (text): Optional. The second number in the Toggl URL, focus.toggl.com//workspaces//... Fill in together with Organization ID.

## Triggers (3)

- [New Project](https://connectors.appmixer.com/connector/appmixer.toggl/1.0.0/component/appmixer.toggl.core.NewProject.md) (`appmixer.toggl.core.NewProject`): Triggers when a project is created in the workspace. Toggl has no webhooks, so the trigger checks every 5 minutes.
- [New Time Entry](https://connectors.appmixer.com/connector/appmixer.toggl/1.0.0/component/appmixer.toggl.core.NewTimeEntry.md) (`appmixer.toggl.core.NewTimeEntry`): Triggers when the connected user creates a time entry that covers the last 30 days, a started timer included. Toggl has no webhooks, so the trigger checks every 5 minutes.
- [Time Entry Updated](https://connectors.appmixer.com/connector/appmixer.toggl/1.0.0/component/appmixer.toggl.core.TimeEntryUpdated.md) (`appmixer.toggl.core.TimeEntryUpdated`): Triggers when a time entry of the connected user that covers the last 30 days is changed, a stopped timer included. Deleted entries do not trigger. Toggl has no webhooks, so the trigger checks every 5 minutes.

## Actions (13)

- [Create Client](https://connectors.appmixer.com/connector/appmixer.toggl/1.0.0/component/appmixer.toggl.core.CreateClient.md) (`appmixer.toggl.core.CreateClient`): Create a client in the workspace.
- [Create Project](https://connectors.appmixer.com/connector/appmixer.toggl/1.0.0/component/appmixer.toggl.core.CreateProject.md) (`appmixer.toggl.core.CreateProject`): Create a project in the workspace.
- [Create Task](https://connectors.appmixer.com/connector/appmixer.toggl/1.0.0/component/appmixer.toggl.core.CreateTask.md) (`appmixer.toggl.core.CreateTask`): Create a task in the workspace, optionally in a project.
- [Create Time Entry](https://connectors.appmixer.com/connector/appmixer.toggl/1.0.0/component/appmixer.toggl.core.CreateTimeEntry.md) (`appmixer.toggl.core.CreateTimeEntry`): Create a time entry of the connected user. Leave Stop and Duration empty to start a running timer (Toggl stops a timer that is already running).
- [Delete Time Entry](https://connectors.appmixer.com/connector/appmixer.toggl/1.0.0/component/appmixer.toggl.core.DeleteTimeEntry.md) (`appmixer.toggl.core.DeleteTimeEntry`): Delete a time entry by its ID.
- [Find Report Time Entries](https://connectors.appmixer.com/connector/appmixer.toggl/1.0.0/component/appmixer.toggl.core.FindReportTimeEntries.md) (`appmixer.toggl.core.FindReportTimeEntries`): Find time entries of all workspace members you may see in reports, in a date range, newest first (up to 1,000). Filter by description, projects, clients and users. Reports follow new and changed entries with a short delay.
- [Find Time Entries](https://connectors.appmixer.com/connector/appmixer.toggl/1.0.0/component/appmixer.toggl.core.FindTimeEntries.md) (`appmixer.toggl.core.FindTimeEntries`): Find the time entries of the connected user that overlap a date range, newest first (up to 1,000). Without dates it returns the last 7 days. For the time of other workspace members use Find Report Time Entries.
- [Get Current Time Entry](https://connectors.appmixer.com/connector/appmixer.toggl/1.0.0/component/appmixer.toggl.core.GetCurrentTimeEntry.md) (`appmixer.toggl.core.GetCurrentTimeEntry`): Get the running timer of the connected user. Goes to the Not Found port when no timer is running.
- [Get Time Entry](https://connectors.appmixer.com/connector/appmixer.toggl/1.0.0/component/appmixer.toggl.core.GetTimeEntry.md) (`appmixer.toggl.core.GetTimeEntry`): Get a time entry by its ID.
- [List Projects](https://connectors.appmixer.com/connector/appmixer.toggl/1.0.0/component/appmixer.toggl.core.ListProjects.md) (`appmixer.toggl.core.ListProjects`): List the projects of the workspace, archived and completed ones included (up to 1,000), sorted by name.
- [Make API Call](https://connectors.appmixer.com/connector/appmixer.toggl/1.0.0/component/appmixer.toggl.core.MakeApiCall.md) (`appmixer.toggl.core.MakeApiCall`): Perform an arbitrary authorized call to the Toggl API. Provide a path relative to https://focus.toggl.com/api (or a full URL on focus.toggl.com), method, headers, query parameters and body. The Authorization header is added automatically.
- [Stop Time Entry](https://connectors.appmixer.com/connector/appmixer.toggl/1.0.0/component/appmixer.toggl.core.StopTimeEntry.md) (`appmixer.toggl.core.StopTimeEntry`): Stop the running timer of the connected user and return the finished time entry. Goes to the Not Found port when no timer is running.
- [Update Time Entry](https://connectors.appmixer.com/connector/appmixer.toggl/1.0.0/component/appmixer.toggl.core.UpdateTimeEntry.md) (`appmixer.toggl.core.UpdateTimeEntry`): Update a time entry. Only the fields you fill in are changed.

## Changelog

### 1.0.0

- Initial release on the Toggl API (focus.toggl.com): time entries (create, get, find, update, delete), running timer (start, current, stop), projects, clients, tasks, report time entries, Make API Call, and polling triggers for new and updated time entries and new projects.
