---
title: "Integrations - QuickBooks Payroll"
url: "https://docs.unified.to/integrations/quickbookspayroll"
description: "Build QuickBooks Payroll integrations faster with our Unified API — HR & Directory data, OAuth2, real-time sync."
date: "2026-11-19T19:27:38.093Z"
updated: "2026-11-19T19:27:38.093Z"
---

# QuickBooks Payroll integration

> What this integration supports through the Unified.to API, by object. Live data: `GET https://api.unified.to/unified/integration?type=quickbookspayroll` with your workspace API key (or Core MCP `list_unified_integrations` with `type: "quickbookspayroll"`). All integrations: https://docs.unified.to/integrations.md

## Overview

- **Type:** `quickbookspayroll`
- **Categories:** [HR & Directory](https://docs.unified.to/hris/overview.md), [Authentication](https://docs.unified.to/auth/overview.md), [Passthrough](https://docs.unified.to/passthrough/overview.md)
- **Website:** https://quickbooks.intuit.com/payroll/
- **Vendor API docs:** https://developer.intuit.com/app/developer/payroll-time/docs/get-started
- **Launched:** 2026-11-19

## How end users connect

- **OAuth2** authorization flow. Register your own OAuth2 app with the vendor and add its credentials to the integration.

## OAuth2 scopes

Pass Unified scopes in `scopes=` on the authorization URL; each one requests these vendor scopes. Request only what you need.

| Unified scope | Vendor scopes |
| --- | --- |
| `hris_benefit_read` | `openid`, `email`, `profile`, `qb.payroll.benefits` |
| `hris_benefit_write` | `openid`, `email`, `profile`, `qb.payroll.benefits` |
| `hris_company_read` | `openid`, `email`, `profile`, `qb.company.read` |
| `hris_deduction_read` | `openid`, `email`, `profile`, `qb.employee.read`, `qb.payroll.benefits` |
| `hris_deduction_write` | `openid`, `email`, `profile`, `qb.payroll.benefits` |
| `hris_employee_read` | `openid`, `email`, `profile`, `qb.employee.read` |
| `hris_location_read` | `openid`, `email`, `profile`, `qb.company.read` |
| `hris_paycode_read` | `openid`, `email`, `profile`, `payroll.compensation.read` |
| `hris_payslip_read` | `openid`, `email`, `profile`, `qb.payroll.compensation.read` |

## Supported objects

| Object | Methods | Webhooks |
| --- | --- | --- |
| [hris_benefit](#hris_benefit) | list, get, create, update | none |
| [hris_company](#hris_company) | list, get | none |
| [hris_deduction](#hris_deduction) | list, create, update, remove | none |
| [hris_employee](#hris_employee) | list, get | none |
| [hris_location](#hris_location) | list | none |
| [hris_paycode](#hris_paycode) | list, get | none |
| [hris_payslip](#hris_payslip) | list, get | created, updated |
| [passthrough](#passthrough) | none | none |

Values below come from the integration's support data. "Required list filters" must be sent on list calls; "Required on create" fields must be sent when creating. Webhook events are `native` (pushed by the vendor) or `virtual` (polled by Unified.to). Anything not listed is not supported; an unsupported method returns `501`.

### hris_benefit

- **Methods:** `list`, `get`, `create`, `update`
- **Webhooks:** none
- **List filters:** `list_limit`, `list_offset`
- **Readable fields:** `code`, `company_id`, `description`, `id`, `is_active`, `name`, `type`
- **Writable fields:** none
- **Required on create:** `code`, `name`
- **Vendor objects:** `Payroll_BenefitPolicy`
- **Model:** https://docs.unified.to/hris/benefit/model.md

### hris_company

- **Methods:** `list`, `get`
- **Webhooks:** none
- **List filters:** `list_limit`, `list_offset`
- **Readable fields:** `address`, `id`, `legal_name`, `name`
- **Writable fields:** none
- **Vendor objects:** `Payroll_EmployerInfo`
- **Model:** https://docs.unified.to/hris/company/model.md

### hris_deduction

- **Methods:** `list`, `create`, `update`, `remove`
- **Webhooks:** none
- **List filters:** `list_limit`, `list_offset`
- **Required list filters:** `list_user_id`
- **Readable fields:** `amount`, `benefit_id`, `company_id`, `employer_amount`, `employer_type`, `frequency`, `id`, `is_active`, `max_amount`, `type`, `user_id`
- **Writable fields:** `amount`, `employer_amount`, `employer_type`, `frequency`, `max_amount`, `type`
- **Required on create:** `benefit_id`, `user_id`
- **Vendor objects:** `Payroll_EmployeeMiscDeduction`, `Payroll_EmployeeBenefit`
- **Model:** https://docs.unified.to/hris/deduction/model.md

### hris_employee

- **Methods:** `list`, `get`
- **Webhooks:** none
- **List filters:** `list_limit`, `list_offset`, `list_order`, `list_query`
- **Readable fields:** `address`, `company_id`, `emails`, `employee_number`, `employment_status`, `first_name`, `gender`, `hired_at`, `id`, `last_name`, `locations`, `name`, `pay_frequency`, `telephones`, `terminated_at`, `title`
- **Writable fields:** none
- **Vendor objects:** `WorkerManagement_Employee`
- **Model:** https://docs.unified.to/hris/employee/model.md

### hris_location

- **Methods:** `list`
- **Webhooks:** none
- **List filters:** `list_limit`, `list_offset`
- **Readable fields:** `address`, `company_id`, `id`, `is_active`
- **Writable fields:** none
- **Vendor objects:** `Payroll_WorkLocation`
- **Model:** https://docs.unified.to/hris/location/model.md

### hris_paycode

- **Methods:** `list`, `get`
- **Webhooks:** none
- **List filters:** `list_limit`, `list_offset`
- **Readable fields:** `code`, `company_id`, `description`, `id`, `is_active`, `name`, `type`
- **Writable fields:** none
- **Vendor objects:** `Payroll_EmployerCompensation`
- **Model:** https://docs.unified.to/hris/paycode/model.md

### hris_payslip

- **Methods:** `list`, `get`
- **Webhooks:** `created` (virtual), `updated` (virtual)
- **Virtual webhook filters:** `virtual_webhook_limit`, `virtual_webhook_updated_gte`, `virtual_webhook_user_id`
- **List filters:** `list_limit`, `list_offset`, `list_updated_gte`, `list_user_id`
- **Readable fields:** `company_id`, `created_at`, `currency`, `deduction_amount`, `details`, `employee_tax_amount`, `employer_contribution_amount`, `employer_tax_amount`, `end_at`, `gross_amount`, `gross_ytd_amount`, `hours`, `id`, `net_amount`, `paid_at`, `start_at`, `type`, `updated_at`, `user_id`
- **Writable fields:** none
- **Vendor objects:** `Payroll_Payslip`
- **Model:** https://docs.unified.to/hris/payslip/model.md

### passthrough

- **Methods:** none
- **Webhooks:** none
- **Readable fields:** none
- **Writable fields:** none
