DEV

Toggl Track

Toggl Track Connection

Put Toggl Track to Work with @Human Automations and @Human Agents

The Toggl Track Connection documents all Triggers, Actions and Query Operations available for creating automations via the Toggl Track API.

What can you do with the Toggl Track Connection?

  • Connect to the Toggl Track API in a few clicks

  • Use the related Toggl Track Operations (see below) in @Human Automations or @Human Agents

Trigger Operations

Time Entry Created

Triggers on: time_entries/time_entry_created

Triggered when a new time entry is created in Toggl Track.

Time Entry Updated

Triggers on: time_entries/time_entry_updated

Triggered when an existing time entry is updated in Toggl Track.

Time Entry Deleted

Triggers on: time_entries/time_entry_deleted

Triggered when a time entry is deleted in Toggl Track.

Project Created

Triggers on: projects/project_created

Triggered when a new project is created in Toggl Track.

Project Updated

Triggers on: projects/project_updated

Triggered when an existing project is updated in Toggl Track.

Project Deleted

Triggers on: projects/project_deleted

Triggered when a project is deleted in Toggl Track.

Workspace Created

Triggers on: workspaces/workspace_created

Triggered when a new workspace is created in Toggl Track.

Action Operations

Action: Create Client

Action: Create User Invitation

Action: Add Project Member

Action: Create Task

Query Operations

Example link

Example link

Obtaining Access Credentials

To obtain a Personal Access Token (PAT) for Toggl Track (system-to-system access), follow these steps:

Required Values

  1. Toggl Track Account – A user account with admin or workspace access (PATs are user-specific).

Steps to Generate PAT

  1. Log in to your Toggl Track account at https://track.toggl.com.

  2. Navigate to Profile Settings:

    • Click your profile icon (top-right) → Profile settings.

  3. Go to API Token:

    • In the left sidebar, select API token.

  4. Generate a New Token:

    • Under Personal API token, click Generate new token.

    • Confirm if prompted.

  5. Copy the Token:

    • The token will be displayed once. Copy it immediately.

    • Store it securely (e.g., password manager, secrets vault).

Token Scope: Full access to the user’s data (workspaces, projects, time entries, etc.). Expiry: Never expires unless revoked manually.

Configuring Webhooks

  1. Log in to your Toggl Track account at https://track.toggl.com.

  2. Navigate to Integrations in the left sidebar.

  3. Select Webhooks.

  4. Click Create Webhook.

  5. Provide a Name for your webhook.

  6. Select the Workspace you want to monitor.

  7. Choose the Events you want to listen for (e.g., Time entry created).

  8. Enter the URL Endpoint where the webhook payloads should be sent.

  9. Click Add Webhook.

Code (Apache v2.0): Service Connectivity and Metadata

Code (Apache v2.0): List of External Resources and Internal Mapping

Last updated