# Clone the repository
git clone https://github.com/example/n8n-nodes-toggl.git
cd n8n-nodes-toggl

# Install dependencies
pnpm install

# Build the nodes
pnpm build

# Link to n8n
cd ~/.n8n/nodes
ln -s /path/to/n8n-nodes-toggl/dist/nodes/Toggl n8n-nodes-toggl

Credentials

You need to set up Toggl API credentials to use this node:

Toggl API Token

Go to your Toggl Profile settings.
Scroll down to the API Token section.
Copy your API token.
In n8n, create new Toggl API credentials.
Paste your API token in the API Token field.

Compatibility

This node requires n8n version 0.187.0 or later.

Usage

Toggl Node

The Toggl node supports the following operations:

Time Entry Operations

Start Time Entry: Start a new time entry with optional project and tags
Stop Time Entry: Stop a running time entry (by ID or current)
Get Current Time Entry: Retrieve the currently running time entry
List Time Entries: Get time entries with date filtering and pagination

Project Operations

Create Project: Create a new project in a workspace
List Projects: Get projects from a workspace with optional archived filter

Client Operations

Create Client: Create a new client in a workspace with optional external reference and notes
List Clients: Get clients from a workspace with status filtering (active, archived, both) and name filtering

Raw Request

Raw Request: Make custom API calls to any Toggl endpoint

Toggl Webhook Trigger

The webhook trigger node allows you to receive real-time notifications when events occur in Toggl:

Project Events: created, updated, deleted
Time Entry Events: created, updated, deleted
Task Events: created, updated, deleted

The webhook trigger automatically:

Creates webhook subscriptions with Toggl
Validates webhook signatures for security
Manages subscription lifecycle (create/delete)

Sample Workflow

Here's a sample workflow that starts a time entry when a new task is created in another system:

{
  "meta": {
    "instanceId": "example"
  },
  "nodes": [
    {
      "parameters": {},
      "name": "Start",
      "type": "n8n-nodes-base.start",
      "typeVersion": 1,
      "position": [240, 300],
      "id": "start-node"
    },
    {
      "parameters": {
        "resource": "timeEntry",
        "operation": "startTimeEntry",
        "description": "Working on {{$json.task_name}}",
        "projectId": "={{$json.project_id}}",
        "tags": "automated,n8n"
      },
      "name": "Start Toggl Timer",
      "type": "n8n-nodes-toggl.toggl",
      "typeVersion": 1,
      "position": [460, 300],
      "id": "toggl-node",
      "credentials": {
        "togglApi": {
          "id": "1",
          "name": "Toggl API"
        }
      }
    }
  ],
  "connections": {
    "Start": {
      "main": [
        [
          {
            "node": "Start Toggl Timer",
            "type": "main",
            "index": 0
          }
        ]
      ]
    }
  }
}

Webhook Workflow Example

Here's a workflow that triggers when a time entry is created in Toggl:

{
  "meta": {
    "instanceId": "example"
  },
  "nodes": [
    {
      "parameters": {
        "workspaceId": 123456,
        "events": ["time_entry:created", "time_entry:updated"],
        "description": "n8n automation webhook"
      },
      "name": "Toggl Webhook",
      "type": "n8n-nodes-toggl.togglWebhookTrigger",
      "typeVersion": 1,
      "position": [240, 300],
      "id": "webhook-trigger",
      "credentials": {
        "togglApi": {
          "id": "1",
          "name": "Toggl API"
        }
      },
      "webhookId": "webhook-id"
    },
    {
      "parameters": {
        "options": {}
      },
      "name": "Process Time Entry",
      "type": "n8n-nodes-base.function",
      "typeVersion": 1,
      "position": [460, 300],
      "id": "function-node"
    }
  ],
  "connections": {
    "Toggl Webhook": {
      "main": [
        [
          {
            "node": "Process Time Entry",
            "type": "main",
            "index": 0
          }
        ]
      ]
    }
  }
}

Common Use Cases

Project Management Integration: Automatically start/stop timers when tasks change status
Reporting: Extract time tracking data for custom reports and dashboards
Team Coordination: Send notifications when team members start/stop work
Billing Automation: Generate invoices based on tracked time
Productivity Monitoring: Track and analyze work patterns

API Reference

This node uses the Toggl Track API v9. All operations support the same parameters and return the same data structures as the official API.

Rate Limiting

The node automatically handles Toggl's rate limiting (429 responses) with exponential backoff retry logic.

Error Handling

API errors are properly wrapped and include helpful error messages. Enable "Continue on Fail" in node settings to handle errors gracefully in your workflows.

Development

Building

pnpm build

Testing

pnpm test

Linting

pnpm lint
pnpm lintfix

Contributing

Fork the repository
Create a feature branch
Make your changes
Add tests for new functionality
Ensure all tests pass and linting is clean
Submit a pull request

License

MIT

Resources

Support

For questions about this node, please open an issue on GitHub.

For general n8n support, visit the n8n community forum.

Keywords

n8n-community-node-package

FAQs

What is n8n-nodes-toggl?

Is n8n-nodes-toggl well maintained?

Package last updated on 15 Jun 2025

Did you know?

Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.

Install

n8n-nodes-toggl