Time tracking integration
Toggl Track hours, split into contracted and uncontracted work.
Reads Toggl Track time entries for client projects and attributes them to contracted deliverables or flagged scope, feeding margin and realization reporting.
- Vendor
- Toggl OÜ
- Plan
- Agency and Scale plans
- Authentication
- Toggl Track API v9 token, plus Toggl Track webhooks
- Setup time
- About 3 minutes
- Sync
- Near real time via Toggl Track webhooks, with nightly reconciliation
Overview
How TWINJAM works with Toggl Track
Toggl Track is popular with design studios and smaller dev shops because people actually use it. TWINJAM turns those entries into a margin signal by attributing each one to a contracted deliverable or to a scope flag, using the project, the task, tags and the entry description.
When a designer logs two hours against Homepage concepts round 3 and the SOW contracts two rounds, TWINJAM counts those hours as uncontracted and attaches them to the open revision-cap flag. The PM sees both the request and the cost already sunk into it, and finance sees realization move in near real time rather than at invoice time.
TWINJAM connects with a workspace admin's API token, reads only the projects you map, and never edits or deletes time entries.
In practice
Hours attached to the right flag
A designer logs two hours to Homepage concepts round 3. TWINJAM links the entry to the open revision-cap flag, so the change order for the extra round can include the time already spent.
The payload on the right is the event TWINJAM emits to your triage feed and to outbound webhooks, so you can route it into your own reporting.
{
"type": "margin.uncontracted_hours.updated",
"id": "mgn_T1g4Wx8C",
"workspace": "CVN-BRAND",
"source": {
"tool": "toggl-track",
"project": "Corvina rebrand",
"entry": "Homepage concepts round 3",
"hours": 2
},
"linked_flag": "rev_A5k1Nf3D",
"hours": {
"contracted": 64,
"uncontracted": 7.5
},
"realization_rate": 0.89
}Permissions
Scopes requested, and why.
| Scope | Why TWINJAM needs it |
|---|---|
| Workspace API token (admin) | Toggl Track uses token authentication. TWINJAM reads only the projects you map. |
Events
What triggers a check.
Webhook: time_entry created / updated
Attributes new and edited entries to deliverables or flags.
Webhook: project updated
Keeps project mapping current.
Poll: reports API, nightly
Reconciles totals against Toggl's own reports.
Setup
Connect Toggl Track in about 3 minutes.
An admin connects once. PMs never need to re-authenticate, and you can revoke access from TWINJAM or the vendor's admin console at any time.
- 1Generate an API token from a Toggl Track workspace admin profile.
- 2Paste it into TWINJAM under Integrations, then Toggl Track.
- 3Map Toggl projects to contract workspaces and tasks or tags to deliverables.
- 4TWINJAM registers its webhooks automatically and backfills 90 days of entries.
FAQ
Toggl Track integration questions
Time entries for mapped projects: duration, description, task, tags, billable flag. Project and client names. It never reads: projects not mapped to a contract; personal or untagged entries outside client projects; desktop activity, idle detection or tracking reminders.
Nothing. Access is read-only in practice; TWINJAM never edits entries. Every action that could reach a client requires a PM to approve it first.
Agency and Scale plans: Agency ($899/mo billed annually), Scale (from $1,800/mo billed annually). Every plan starts with a 14-day free production trial.
Near real time via Toggl Track webhooks, with nightly reconciliation. Setup takes about 3 minutes.
Related integrations
All integrationsHarvestTime tracking
Pulls Harvest time entries by project and task, splits hours into contracted and uncontracted work, and syncs approved change orders back as billable budget.
ClockifyTime tracking
Syncs Clockify time entries for client projects and splits them into contracted, uncontracted and recovered hours for margin telemetry.
AsanaProject management
Maps Asana tasks and sections to SOW deliverables, flags tasks with no contractual home, and counts revision rounds against contracted caps.
Put Toggl Track on the same page as your SOW.
Connect it during a 14-day free production trial and see the first flags from your live projects within days.