# QuickBooks Employee API

**Canonical:** https://apis.io/apis/quickbooks/quickbooks-employee-api/  
**Provider:** QuickBooks — https://apis.io/providers/quickbooks/  
**Base URL:** https://quickbooks.api.intuit.com  
**Documentation:** https://developer.intuit.com/app/developer/qbo/docs/develop

QuickBooks Employee API is one of 82 APIs that [QuickBooks](https://apis.io/providers/quickbooks/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification and an AsyncAPI event-driven specification. This API exposes 12 JSON Schema definitions. Tagged areas include Employee. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, an API reference, a getting-started guide, authentication docs, an AsyncAPI specification, and 12 JSON Schemas.

An Employee object represents a person working for the company. If you are looking to create a Contractor via API, refer how to create a Vendor object, with Vendor1099 field set to true.The DisplayName, Title, GivenName, MiddleName, FamilyName, Suffix, and PrintOnCheckName attributes must not contain colon (:), tab (\t), or newline (\n) characters. The DisplayName attribute must be unique across all other customer, employee, and vendor objects. The GivenName and FamilyName attributes are required. The PrimaryEmailAddress attribute must contain an at sign (@) and dot (.). The full complement of read, create, delete via deactivation (active=false), and update operations are available both with and without QuickBooks Payroll enabled. However, when Payroll is enabled, support for some attributes is limited: Title—Not supported when QuickBooks Payroll is enabled. Suffix—Not supported when QuickBooks Payroll is enabled. DisplayName —It’s read only when QuickBooks Payroll is enabled and a concatenation of GivenName MiddleName FamilyName. PrintOnCheckName—Not supported when QuickBooks Payroll is enabled. BillRate—Not supported when QuickBooks Payroll is enabled. SSN—Masked SSNs, as is returned in a response, cannot be passed in a request when QuickBooks Payroll is enabled. Code for this field must be removed before submitting.

## Operations (3)

| Method | Path | Summary |
|---|---|---|
| GET | `/v3/company/{realmID}/query` | Query an entity with a SELECT statement |
| POST | `/v3/company/{realmID}/employee` | Create an employee / Full update an employee |
| GET | `/v3/company/{realmID}/employee/{employeeId}` | Read an employee |

## Machine-readable artifacts (23)

- **OpenAPI** — https://artifacts.apis.io/quickbooks/openapi/quickbooks-employee-api-openapi.yml
- **Documentation** — https://developer.intuit.com/app/developer/qbo/docs/develop
- **APIReference** — https://developer.intuit.com/app/developer/qbo/docs/api/accounting/most-commonly-used/account
- **GettingStarted** — https://developer.intuit.com/app/developer/qbo/docs/get-started
- **Authentication** — https://developer.intuit.com/app/developer/qbo/docs/develop/authentication-and-authorization/oauth-2.0
- **AsyncAPI** — https://artifacts.apis.io/quickbooks/asyncapi/quickbooks-online-webhooks-asyncapi.yml
- **JSONSchema** — https://artifacts.apis.io/quickbooks/json-schema/quickbooks-invoiceresponse-schema.json
- **JSONSchema** — https://artifacts.apis.io/quickbooks/json-schema/quickbooks-salesreceiptresponse-schema.json
- **JSONSchema** — https://artifacts.apis.io/quickbooks/json-schema/quickbooks-estimateresponse-schema.json
- **JSONSchema** — https://artifacts.apis.io/quickbooks/json-schema/quickbooks-refundreceiptresponse-schema.json
- **JSONSchema** — https://artifacts.apis.io/quickbooks/json-schema/quickbooks-customerresponse-schema.json
- **JSONSchema** — https://artifacts.apis.io/quickbooks/json-schema/quickbooks-creditmemoresponse-schema.json
- **Documentation** — https://developer.intuit.com/app/developer/qbpayments/docs/develop
- **APIReference** — https://developer.intuit.com/app/developer/qbpayments/docs/api/resources/all-entities/charges
- **JSONSchema** — https://artifacts.apis.io/quickbooks/json-schema/quickbooks-chargeresponse-schema.json
- **JSONSchema** — https://artifacts.apis.io/quickbooks/json-schema/quickbooks-card-schema.json
- **JSONSchema** — https://artifacts.apis.io/quickbooks/json-schema/quickbooks-bankaccount-schema.json
- **JSONSchema** — https://artifacts.apis.io/quickbooks/json-schema/quickbooks-echeckresponse-schema.json
- **JSONSchema** — https://artifacts.apis.io/quickbooks/json-schema/quickbooks-chargerequest-schema.json
- **JSONSchema** — https://artifacts.apis.io/quickbooks/json-schema/quickbooks-bankaccountrequest-schema.json
- **Documentation** — https://developer.intuit.com/app/developer/qbo/docs/api/accounting/all-entities/account
- **Sandbox** — https://sandbox-quickbooks.api.intuit.com/v3/company/{realmId}
- **API Explorer** — https://developer.intuit.com/app/developer/qbo/docs/api/accounting/most-commonly-used/account

## Other QuickBooks APIs (12)

- [QuickBooks Online GraphQL API](https://apis.io/apis/quickbooks/graphql/)
- [QuickBooks Workforce Payroll API](https://apis.io/apis/quickbooks/payroll/)
- [QuickBooks Account API](https://apis.io/apis/quickbooks/quickbooks-account-api/)
- [QuickBooks Account List Detail API](https://apis.io/apis/quickbooks/quickbooks-accountlistdetail-api/)
- [QuickBooks AP Aging Detail API](https://apis.io/apis/quickbooks/quickbooks-apagingdetail-api/)
- [QuickBooks AP Aging Summary API](https://apis.io/apis/quickbooks/quickbooks-apagingsummary-api/)
- [QuickBooks AR Aging Detail API](https://apis.io/apis/quickbooks/quickbooks-aragingdetail-api/)
- [QuickBooks AR Aging Summary API](https://apis.io/apis/quickbooks/quickbooks-aragingsummary-api/)
- [QuickBooks Attachable API](https://apis.io/apis/quickbooks/quickbooks-attachable-api/)
- [QuickBooks Balance Sheet API](https://apis.io/apis/quickbooks/quickbooks-balancesheet-api/)
- [QuickBooks Batch API](https://apis.io/apis/quickbooks/quickbooks-batch-api/)
- [QuickBooks Bill API](https://apis.io/apis/quickbooks/quickbooks-bill-api/)

## Tags

Employee

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/quickbooks/quickbooks-employee-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/quickbooks/.