> ## Documentation Index
> Fetch the complete documentation index at: https://docs.asteragents.com/llms.txt
> Use this file to discover all available pages before exploring further.

# QuickBooks Time

> Connect QuickBooks Time timesheets and payroll hours to your agents

## Connect QuickBooks Time

An Aster organization admin connects QuickBooks Time in **Control Hub > Integrations > QuickBooks Time** with an access token. The connection is shared across the organization. QuickBooks Time is separate from QuickBooks Online and has its own token.

1. In QuickBooks Time, sign in as an admin and open **Feature Add-ons > Manage Add-ons**, then install the **API** add-on if it isn't already.
2. In the API add-on, click **Add a new application**, give it a name such as "Aster", and save.
3. Copy the application's **access token**. Set its expiration date as far out as QuickBooks Time allows, so the connection doesn't lapse.
4. Paste the token into Aster and save. Aster reads one user to check the token before saving.
5. Enable the QuickBooks Time tools on your agent.

The token reads whatever its QuickBooks Time user can see, so create it as an admin. See QuickBooks Time's [API documentation](https://tsheetsteam.github.io/api_docs/) for details.

## Available tools

| Tool | Use |
| - | - |
| `quickbooks_time_timesheets` | Read timesheets (clock-in/out entries) with user and jobcode names. Needs `start_date`, `modified_since`, or `ids`. |
| `quickbooks_time_reports` | `action=payroll` (regular, overtime, and PTO per user), `payroll_by_jobcode` (one row per user, date, and jobcode), `project` (hours by user, group, jobcode, and custom field), or `current_totals` (who is on the clock now). |
| `quickbooks_time_lookup` | `action=users`, `jobcodes`, `groups`, or `customfields` to find names and IDs. |

Dates use `YYYY-MM-DD`. Durations and payroll totals are in seconds; the project report returns hours. Timesheets exclude shifts still on the clock unless `on_the_clock` is `yes` or `both`.

List calls return up to 200 rows per page. While `more` is true, call again with `next_page` as `page` and the same filters. Large results are attached to the conversation as JSON.

## Example prompts

* "How many hours did each technician work last week, with overtime?"
* "Break October's hours down by jobcode for the service crew."
* "Who is on the clock right now?"
* "List timesheets for Ana Diaz from November 1 to 7."

## Troubleshooting

* **401:** The token expired or was deleted. Create or extend it in the API add-on, then reconnect.
* **403:** The token's user lacks permission. Use an admin's token.
* **429:** QuickBooks Time allows 300 requests per 5 minutes. Wait and retry.

The tools are read-only. The token stays server-side and is redacted in connection responses. To rotate it, edit the connection; to remove it, disconnect QuickBooks Time in Integrations.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.