WakaTime Invoice Integration: Setup and Hours Review
Connect your WakaTime account, choose a project and work period, and turn recorded coding hours into an invoice line. Compare that activity with approved client work before billing, then decide whether the amount should refresh at send time.
At a glance
Connect WakaTime to invoice coding hours. Check project scope, history limits, rates, and send-time refresh with a worked example and free review checklist.
Best for
Independent developers and technical consultants billing their own approved coding time by project.
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 own WakaTime account and reconcile one short, approved work period before scheduling its invoice.
Illustrative example
Example: a weekly coding invoice at $65 per hour
- Project and period
- Client portal, September 24–30, 2026. Confirm that this range is available on the day you import.
- Source duration
- 58,500 recorded seconds ÷ 3,600 = 16.25 hours. Assume all of this activity is approved client work.
- Draft charge
- 16.25 hours × $65 USD = $1,056.25 before tax or conversion.
- Later correction
- Another 2,700 seconds in the same period adds 0.75 hour. A successful refresh returns 17 hours × $65 = $1,105.
Invented arithmetic example, not a customer invoice. Available history changes with the current date; a range accepted while drafting can be too old when a delayed invoice refreshes.
See the recorded product workflowConnect coding activity to an agreed billing period
Start in the Integrations area of your InvoiceAgent account and choose Connect WakaTime. Authorize the intended WakaTime account, return to InvoiceAgent, and select WakaTime in the invoice form's time-tracking controls. Choose the project, work period, hourly rate, and source currency. The import uses the connected user's project summaries, so it should not be treated as a report of every developer on a client project.
Inspect the history-access message before choosing dates. InvoiceAgent currently permits the last seven days when WakaTime free access is detected, and falls back to that limit if access detection fails. Detected premium access removes that local seven-day restriction. It does not establish that every historical period contains recoverable activity. Future end dates are rejected. If a paid account appears limited, reconnect and confirm the displayed access before retrying an older period.
Treat imported time as a draft input. Check project naming, dates, and approved scope against your source report and agreement. Coding activity does not cover every billable meeting or prove that every recorded minute is billable. Add approved fixed extras separately. Choose send-time refresh only when changes to that project's recorded hours should change the invoice; review the saved PDF before its scheduled send.
Quick context
Section
Integration pages for Google Drive, WakaTime, and Toggl Track workflows tied to invoice creation, delivery, and records.
Best for
Independent developers and technical consultants billing their own approved coding time by project.
Outcome
Use this page to move from general research into a calmer, more repeatable invoicing process.
Connect, reconcile, and choose the refresh behavior
1. Confirm the account and history
Finish WakaTime authorization and load the project list in the invoice form. Check the access message and choose a supported period ending no later than today. If projects are missing, confirm the connected account and source project name before using another project's hours as a substitute.
2. Compare the returned time with approved work
Read the same project's report for the same dates and inspect activity near period boundaries. Confirm the client's hourly rate and currency separately; the integration does not import a contractual rate. In the example, the expected line is $1,056.25 only if all 16.25 hours are approved. Keep any separately agreed meeting fee distinct from the imported coding line.
3. Review the amount that will send
The Refresh tracked hours at send time control recalculates the managed line using the saved project, rate, and relative date window. If the client has approved a fixed amount, disable refresh and review that amount before scheduling. For recurring invoices, check the next period for gaps or overlaps; relative day offsets are not a guarantee of calendar-month coverage.
Sources and further reading
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 WakaTime checklist (.txt)When a WakaTime import needs another check
Avoid this
A month-old period may be unavailable
A connection limited to recent history cannot reliably refresh last month's work later. Check access at drafting and dispatch. If the source cannot supply the agreed period, use an independently verified report and a manual invoice amount rather than shortening the dates and silently omitting work.
Avoid this
Coding activity and billable effort differ
Review experiments, internal work, meetings, and client approvals outside the imported total. The integration does not decide which recorded work your client owes for. Correct the source or use a reviewed manual amount when the approved scope differs from the returned activity.
Avoid this
Connection errors need repair before retry
If an enabled send-time refresh cannot retrieve hours, inspect the invoice's error and restore the connection or permitted date range before retrying. Do not assume the old preview will automatically be used. Check the current send status before creating another invoice for the same work.
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.
How do I connect WakaTime to InvoiceAgent?
Choose Connect WakaTime in your account's Integrations area, authorize your WakaTime account, and return to the invoice form. Select WakaTime, a project, dates, and an agreed hourly rate.
Can I invoice a full month of WakaTime history?
Check the detected history access first. InvoiceAgent currently restricts free or undetected access to the last seven days; detected premium access removes that local limit. The source must still provide the requested period.
Does WakaTime decide which hours are billable?
No. InvoiceAgent imports recorded project activity. Compare it with approved client work and handle non-billable activity or missing billable work before sending.
Can the amount change after I preview it?
Yes, when send-time hour refresh is enabled and the source total changes. Review late corrections and recurring date windows. Disable refresh when the saved amount must stay fixed.
Related pages
Useful tools
Decision pages
Compare software by the delivery, payment, and follow-up features you need.