Toggl Track Invoice Integration: Setup and Billing Checks
Connect Toggl Track with your API token, choose a project and period, and review the returned personal entries before invoicing. Check the approved scope and dates carefully: the current import does not aggregate your team's time or filter entries by billable flag.
At a glance
Connect Toggl Track to invoice personal project hours. Check API-token setup, billable scope, UTC dates, and refresh limits with a free billing checklist.
Best for
Consultants and freelancers billing from their own Toggl project entries; agency owners checking whether personal imports match the intended invoice scope.
Evaluation method
Reviewed 2026-09-30
Reviewed by the InvoiceAgent editorial team against the current connection, import, and archive implementation and cited provider documentation. Examples are illustrative; this is a source review, not a live integration test or measured customer result.
Using InvoiceAgent
Connect your Toggl account and reconcile one project's returned hours against its approved billing report before sending.
Illustrative example
Example: 11 tracked hours but 10 approved billable hours
- Completed client work
- 8 hours implementation + 2 hours approved client calls on the selected project.
- Internal entry
- 1 hour internal planning assigned to that same project, outside the client's billable agreement.
- Imported total
- 11 positive-duration hours × $90 USD = $990. The import does not remove the internal entry by its billable flag.
- Reviewed amount
- 10 approved hours × $90 USD = $900. Correct project allocation or use a reviewed manual line with refresh disabled.
- Running timer
- An unfinished timer with a non-positive duration does not contribute to this import. Stop and verify it before including its work.
Invented example with no tax or FX. Do not subtract the internal hour only in the draft while leaving a refresh enabled that can restore the raw project total.
See the recorded product workflowKnow which Toggl entries become an invoice line
In your InvoiceAgent account, open Integrations, enter your own Toggl API token, and choose Connect Toggl. The connection checks access by loading your available projects. In the invoice form, select Toggl Track, the intended project, start and end dates, an hourly rate, and the source currency. Do not put the token in invoice notes, an email message, or a checklist; those are billing records rather than connection settings.
The current import reads the connected user's time entries and totals entries matching the selected project with a duration greater than zero. It does not collect every team member's entries or apply a billable-only filter. A shared project name is therefore insufficient proof that the amount covers the entire project or only approved paid work. For team billing, reconcile an approved team report and use a manually reviewed invoice if the personal import cannot represent it.
InvoiceAgent requests the selected dates using UTC day boundaries. Compare them with the report's timezone, especially for work near midnight. The hourly rate comes from your invoice settings, not a Toggl rate lookup. The line amount uses the returned hours and rounds to cents, while the visible hours label uses two decimal places. Reconcile the underlying duration when a small rounding difference appears.
Quick context
Section
Integration pages for Google Drive, WakaTime, and Toggl Track workflows tied to invoice creation, delivery, and records.
Best for
Consultants and freelancers billing from their own Toggl project entries; agency owners checking whether personal imports match the intended invoice scope.
Outcome
Use this page to move from general research into a calmer, more repeatable invoicing process.
Connect the token and reconcile a personal billing period
1. Check project access
Connect the intended Toggl token, then select the project from the invoice form's list. If the connection fails, check token validity and that the account can access the project. Loading projects checks authentication; it does not establish that the selected period contains all the time required for billing.
2. Match the report's scope and dates
Compare the selected user's entries with the same project and work period in Toggl. Inspect finished timers, internal entries, and work around UTC midnight. In the example, the raw $990 must be reconciled to the approved $900 before delivery. Review another team member's hours separately instead of assuming they were included.
3. Choose fixed billing or ongoing refresh
Enable send-time refresh only when the returned project total is the amount you intend to bill. Otherwise use a reviewed fixed line and disable refresh. Check that a manual line does not duplicate an existing imported line. Preview the saved invoice and confirm its period, amount, currency, and deadline before scheduling.
Free resource
Take the example into your next billing review
Download the worked example and a checklist you can fill in for your own client. No signup required.
Download the Toggl billing checklist (.txt)Toggl report differences that change the invoice
Avoid this
A personal import is not a team report
The connected account determines whose entries are read. A 10-hour personal result does not establish that the whole team worked 10 hours. Keep the report owner and invoice scope in the review record so client billing can be traced to the intended evidence.
Avoid this
Billable flags do not filter this import
Positive project entries can include internal work even when marked non-billable in Toggl. Review source allocation or use a manual approved total. A preview that happens to match your report today does not guarantee future corrections will follow the same billing policy.
Avoid this
Changing or disconnecting the token affects refresh
Disconnect removes InvoiceAgent's stored Toggl connection; it does not revoke the token at Toggl. If you replace the token, reconnect with the new value and confirm project access before an enabled refresh is due. Review any failed invoice before retrying delivery.
Move from reading about the workflow to running it.
InvoiceAgent is designed for the last mile of getting paid: scheduled invoice delivery, reminder timing, professional PDFs, and send-time FX conversion when global billing is involved.
Related topics
Find more integrations and practical tools in the resources below.
Questions people usually have before changing the workflow.
Does InvoiceAgent use Toggl OAuth?
The current Toggl connection uses the API token entered in your account's Integrations area. WakaTime uses a separate authorization flow.
Does the Toggl import include my whole team?
No. It reads the connected user's entries for the selected project. Reconcile an approved team report separately when billing several people's work.
Are non-billable Toggl entries excluded automatically?
No. The current import filters by project and positive duration, not by billable flag. Review approved scope before using the returned total as an invoice amount.
Why can my imported total differ from a Toggl report?
Check the connected user, project, report timezone, UTC date boundaries, unfinished timers, and billable filters. InvoiceAgent's import may represent a different scope than the report you are comparing.
Related pages
Useful tools
Decision pages
Compare software by the delivery, payment, and follow-up features you need.