Connect Toggl
Time-tracked hours per project + tag breakdowns per employee.
Prerequisites
- Toggl Track account with the API token enabled (Free plan works)
- A PerfCopilot admin account (the Connect button is only visible to admins)
1. Generate credentials in Toggl
- Sign in to https://track.toggl.com.
- Click your avatar in the bottom-left → Profile settings → scroll to API Token.
📖 Official guide: Where is my API key located? — Toggl's own documentation for creating this credential.
- Click Reveal, then copy the token.
Copy these values; you'll paste them in the next step:
API token
2. Paste into PerfCopilot
-
Open Integrations on your PerfCopilot admin.
-
Find the Toggl card and click Connect (or Manage if already configured).
-
Paste each value into the matching field:
| Field in PerfCopilot | Value from step 1 | |---|---| | API token |
<your value>| -
Click Save.
3. Verify
Click Test in the drawer. Expected:
✅ Authenticated as your.name@company.com
If you see a red error, jump to Common errors.
Common errors
| Message | What it usually means | Fix |
|---|---|---|
| HTTP 403: incorrect api token | The token was copied with a leading/trailing space. | Re-copy the token from Toggl, making sure no whitespace is included, and re-paste. |
| HTTP 401: <body excerpt> | Credentials rejected. | Re-check that you copied the full token, no leading/trailing whitespace. |
What signals we pull
attendance— hours logged
Need a feature you don't see? Tell us →.