Skip to main content

Project management: Time import

Import time tracked in ClickUp into InvoiceQuickly and bill it

On the Business plan, InvoiceQuickly connects to ClickUp with your personal API token. You choose a Workspace and a date range of up to 92 days, preview the time entries you tracked on tasks, with the task name, List and billable flag, and import only the entries you select. ClickUp's time entries carry no hourly rate, so you add one in InvoiceQuickly, then select unbilled work into one draft invoice and review it. Tasks without tracked time are not imported, and finishing a task never makes it billable. The import only reads from ClickUp and changes nothing there.

How it works

Connecting ClickUp to InvoiceQuickly, step by step

  1. Step 1: Generate a personal API token in ClickUp

    In ClickUp, click your avatar in the upper-right corner, choose Settings, then Apps. Under API Token, click Generate and copy the token. Personal tokens start with pk_. Regenerating it later cuts off InvoiceQuickly's access until you connect again.

  2. Step 2: Connect ClickUp in InvoiceQuickly

    An owner or admin opens Integrations, then Time tracking imports, and chooses Connect on the ClickUp card. Paste the token. InvoiceQuickly checks it with ClickUp before saving anything, then stores it encrypted. The token is never shown again or sent back to your browser.

  3. Step 3: Choose the Workspace to read from

    If you belong to more than one ClickUp Workspace, pick one from the list ClickUp returns. Time is imported from one Workspace at a time, and you can change it later with Change workspace.

  4. Step 4: Preview a date range

    Choose From and To dates up to 92 days apart and click Preview. InvoiceQuickly reads your own time entries in that Workspace, by start time in your ClickUp time zone, in blocks of up to 30 days, up to 2,000 entries. Nothing is saved yet. Running timers are left out, and entries you imported before are marked Imported.

  5. Step 5: Select entries and confirm billable

    Each row shows the task name and entry description, the List it sits in, the duration, the task status for reference and No rate. Billable starts on only where the ClickUp time entry is marked billable, never because a task is complete. Switch it per row, and leave out work you do not plan to invoice.

  6. Step 6: Import, add rates, then bill on a draft invoice

    Click Import. InvoiceQuickly reads ClickUp again, so only current data is saved, and skips anything already imported. On the Time page, add an hourly rate to each entry or assign a project that has one. Then open Review unbilled work, select the work for one client, review the lines and create a draft invoice.

Why connect it

What connecting ClickUp gives you

What you get

  • No retyping: task name, description, start and end time, duration and the billable flag come straight from each ClickUp time entry
  • The List, Folder or Space a task sits in is shown, so you can tell one client's work from another's in the preview
  • A task's status is shown for reference only, so closing a task never puts it on an invoice by itself
  • You see every entry before anything is saved, and only the rows you select are imported
  • Importing the same range again never creates duplicates: each ClickUp time entry can be imported once per organization
  • ClickUp is only read: the connection never changes tasks, statuses or time entries in your Workspace

Best for

  • Agencies and freelancers who log time on ClickUp tasks and want to invoice that time without copying it by hand
  • Teams that run client work in ClickUp Lists and want to pick one client's tracked time for a month
  • Owners who bill one rate per client or project and are happy to set that rate in InvoiceQuickly
  • Not a fit if you bill a fixed price per task: tasks without tracked time are not imported, so add fixed-fee lines to the invoice yourself
  • Not a fit if you need the whole team's ClickUp time: the connection reads only the entries of the person whose token is used

Reference

What the import reads from ClickUp and what it becomes

Each finished ClickUp time entry you select becomes one InvoiceQuickly time entry. This is how each field is handled.

ClickUp dataIn InvoiceQuicklyNotes
Task name and entry descriptionTime entry descriptionCombined as Task: description; if both are empty, the List name, then ClickUp time entry
Start and end timeStart and end timeThe date range is read in the time zone set in your ClickUp profile
DurationDuration, to the secondEntries over 24 hours are refused; split them in ClickUp first
Billable flag on the time entryBillable, which you confirm per rowEntries without the flag start as not billable
List, Folder or SpaceShown in the preview onlyThe List name, or the Folder or Space when there is no List name
Task statusShown in the preview onlyFor reference; it never decides whether work is billable
Hourly rateNot importedClickUp time entries carry no rate or currency; add a rate in InvoiceQuickly before billing
Tasks with no tracked timeNot importedOnly time entries are read; a task's estimate or due date is not billed

Scroll sideways to see every column.

Entries are saved in your InvoiceQuickly organization's default currency, because ClickUp sends no rate or currency with a time entry. Set that default to the currency you bill the client in before you import.

Reference

Worked example: ClickUp time priced and billed

Example data, not a real client. Four billable ClickUp time entries on two tasks, each given a $75.00 rate on the Time page, billed with Group by project and description.

ClickUp task: descriptionDurationsGrouped quantityRateInvoice line
Homepage redesign: build2 h 10 min + 1 h 50 min4.00$75.00$300.00
Checkout bug: fix0 h 40 min + 0 h 25 min1.08$75.00$81.00
Total5 h 05 min5.08$381.00

Scroll sideways to see every column.

Grouping adds up the seconds of entries with the same description and rate, then rounds once, half up to two decimals: 1 h 05 min is 1.0833 h and bills as 1.08 h. With One line per entry, each entry is rounded on its own and gets its own line with its date.

Setup

Setting it up

You need the InvoiceQuickly Business plan ($19/month or $190/year) and the owner or admin role in your InvoiceQuickly organization; members and viewers can see whether ClickUp is connected but cannot connect or import. In ClickUp you need your own personal API token, and the time must be tracked on tasks with ClickUp time tracking. If your ClickUp plan does not let you mark time entries billable, every entry starts as not billable in the preview and you switch on the ones to invoice. ClickUp limits each token to 100 requests a minute on most plans, which a preview stays well inside. Before the first import, set your InvoiceQuickly default currency to the one you bill in, check the time zone in your ClickUp profile, and create InvoiceQuickly projects with an hourly rate for the clients you bill most, so imported entries can take the project rate. Then preview last month, import it, and compare the hours on the Time page with ClickUp's timesheet before you bill anything.

Good practice

Best practices

Write descriptions the client can read

The task name and the time entry's description become the invoice line text. Name tasks plainly and add a short note when you track time, and the draft invoice needs little editing. You can still edit every line before you create the draft.

Give projects a rate in InvoiceQuickly

An entry with no rate of its own is billed at its project's rate when the project uses the same currency. Assign imported entries to a project with a rate and you set the price once instead of on every entry.

Bill time, not task status

Billable comes only from the time entry's billable flag and your choice in the preview. Moving a task to Complete does not make its time billable, so check the flags before you import.

Import closed periods

Import a period after it ends. Running timers are not listed, and edits you make in ClickUp after importing an entry do not reach InvoiceQuickly, because an imported entry is skipped from then on.

Troubleshooting

Common issues

ClickUp rejected the token

The token was mistyped or regenerated. Copy the current token from Settings, Apps, API Token in ClickUp and connect again. A rejected token marks the connection as needing attention until you do.

A teammate's time is missing from the preview

The connection reads only the time entries of the person whose token is used. ClickUp only returns other members' time to Workspace owners and admins on request, and InvoiceQuickly does not ask for it.

Billing says some time entries have no hourly rate

Imported ClickUp entries have no rate. Edit each entry on the Time page to add an hourly rate, or assign a project with a rate in the same currency, then review the unbilled work again.

ClickUp is limiting requests

ClickUp limits requests per token per minute, and InvoiceQuickly also limits how often one organization can call a provider. Wait for the time shown, then preview again.

Scope

What the ClickUp connection does not do

  • It is not continuous and not two-way. Nothing runs on a schedule: each preview and import is started by an owner or admin.
  • Nothing is written back to ClickUp. Tasks, statuses and time entries are not changed, closed or marked invoiced there.
  • Only tracked time entries are imported. Tasks without time, estimates, custom fields and comments are not.
  • It reads only the time of the person whose token is used, in one Workspace at a time, and ClickUp sends no rate, so every entry needs a rate in InvoiceQuickly.
  • A preview covers at most 92 days and 2,000 entries. Running timers are not listed, and entries over 24 hours cannot be imported.
  • Imported entries are not linked to an InvoiceQuickly project or client, and changes made in ClickUp after import are not picked up.
  • Work imports are on the Business plan only. On Pro you can still track time with InvoiceQuickly's own timer, add entries by hand or type invoice lines yourself.

Questions

ClickUp and InvoiceQuickly: questions

Does InvoiceQuickly import from ClickUp?

Yes, on the Business plan. An owner or admin connects ClickUp with a personal API token, previews a date range of up to 92 days, and imports the time entries they select. Each becomes an InvoiceQuickly time entry with the task name, description, times, duration and billable flag.

Are ClickUp tasks imported, or only time?

Only time tracked on tasks. A task with no tracked time has no hours to bill and is not imported, and a task's status, such as Complete, is shown for reference only. It never makes work billable; the time entry's billable flag and your choice in the preview do.

Is it a continuous connection, and does it update ClickUp?

No to both. Nothing runs in the background or on a schedule; you start every preview and import. InvoiceQuickly only reads from ClickUp, so it never changes tasks, statuses or time entries there.

Why do imported ClickUp entries have no rate?

ClickUp's time entries endpoint returns no hourly rate or currency, and InvoiceQuickly never guesses one. Add a rate to the entry on the Time page, or assign it to an InvoiceQuickly project that has a rate in the same currency, before you bill it.

Can the same ClickUp time entry be imported twice?

No. Each ClickUp time entry is recorded against your organization when it is imported, and later previews mark it Imported and skip it. Disconnecting does not clear this record, so reconnecting later does not create duplicates.

What if I am on the InvoiceQuickly Pro plan?

ClickUp imports are on Business only. On Pro you can track time with InvoiceQuickly's timer or add entries by hand, then bill unbilled time and expenses into a draft invoice the same way, or type hours and rates as invoice lines.

Sources

Official documentation

The ClickUp steps on this page follow these official pages. Menus and plan limits change, so check them before you rely on a detail.

Create your first invoice

The ClickUp connection needs Business: $19/month or $190/year, with everything in Pro plus QuickBooks Online and Xero export and work imports from Clockify, Toggl Track, Harvest and ClickUp. Want to try invoicing first? The Free plan covers 5 invoices in total with PDF download.

Start with Business

Last verified: October 2026