Import Upwork timesheets

Import Upwork timesheets

Upwork's own terms don't allow apps like Handl to connect directly to your account, so importing Upwork payments works a little differently — via a simple CSV upload instead of a live connection.

Steps

1. In Upwork, go to Reports → Transaction History and export a CSV covering the period you want to import.
2. In Handl, go to Settings → Team → Contractor Payments.
3. Upload the CSV (up to 2MB).
4. Handl matches each freelancer name in the file to a team member and suggests how to treat each one: already logged via timesheet (record the payment only, so hours aren't double-counted) or count as cost (use the Upwork payment itself as that person's cost).
5. Confirm the suggested mappings — or adjust them — and import.

Good to know

• There's no live "connect your Upwork account" option — this is intentional, not a missing feature, because of Upwork's platform terms.
• Re-uploading the same file won't create duplicate payments.
• Choose "already logged via timesheet" for contractors who also track their hours through a connected time tracker, so their cost isn't counted twice.
• Choose "count as cost" for contractors whose Upwork payment is your only record of what they cost you.

FAQs

Which Upwork report do I need? Reports → Transaction History, exported as CSV.

What if a freelancer's name doesn't match a team member? You'll be prompted to map it manually before importing.

How often should I import? As often as suits your billing cycle — many agencies do it monthly, alongside reconciling contractor costs.