Justworks website screenshot

Justworks

Justworks is a New York City-based Professional Employer Organization (PEO) and small-business HR platform. It bundles payroll, tax filing, multi-state compliance, large-group medical/dental/vision benefits, 401(k) administration, workers comp, time tracking, and HR consulting into a single per-employee-per-month subscription. Justworks operates four primary products: Justworks Payroll (standalone payroll), Justworks PEO Basic, Justworks PEO Plus (PEO with included benefits package), and Justworks EOR International for hiring full-time employees abroad without a local entity. Justworks exposes a Partner API at public-api.justworks.com for approved integration partners, covering Members, Company, Payroll, Paystubs, Deductions, Time Off, and Webhooks. The API uses OAuth 2.0 authorization-code grant, cursor pagination, signed at-least-once webhooks, and zero-decimal currency representation. Deductions is the primary write surface; everything else is read-only.

7 APIs 18 Features
PEOPayrollHRHuman ResourcesBenefitsHealth Insurance401(k)Time OffComplianceSmall BusinessEmployer of RecordHRIS

APIs

Justworks Members API

Read employee, contractor, and member information from the Justworks Partner API. Provides access to member profiles, employment history, pay history, custom-field values, and U...

Justworks Company API

Read company-level data from the Justworks Partner API including company identity, departments, offices, bank account on file (masked), verified business information, custom-fie...

Justworks Payroll API

Read payroll runs, fees, and paystubs. Each payroll record summarizes gross pay, net pay, employee and employer taxes, and debit information; paystubs break down per-member earn...

Justworks Deductions API

Manage employee deductions — list deduction types, create one-time and recurring deductions, update existing deductions, and cancel deductions in bulk. The primary write surface...

Justworks Time Off API

Manage time-off balances, policies, and requests. Balance reports are asynchronous — submit a POST, then poll the report endpoint until ready. Policies and requests are paginate...

Justworks Webhooks API

Manage Justworks Partner API webhooks. Justworks signs every request, delivers events at-least-once with automatic retries, and closes a webhook on sustained failures (resumable...

Justworks OAuth API

OAuth 2.0 token endpoints for the Justworks Partner API. Authorization code is the only supported grant for initial token acquisition; refresh token grant is supported for renew...

Collections

Pricing Plans

Justworks Plans Pricing

5 plans

PLANS

Rate Limits

Justworks Rate Limits

2 limits

RATE LIMITS

FinOps

Features

Justworks PEO Basic — co-employment PEO with payroll, HR support, and access to large-group benefits
Justworks PEO Plus — PEO Basic plus medical, dental, vision, life, AD&D, disability, and 401(k) administration
Justworks Payroll — standalone small-business payroll, time tracking, and HR tooling for companies that source their own benefits
Justworks EOR International — employer-of-record service for hiring full-time employees abroad without a local entity
Justworks Partner API at public-api.justworks.com with OAuth 2.0 authorization-code flow
Members endpoints (list, get, custom field values, tax-id/SSN) with cursor pagination and updated_at filtering
Company endpoints (identity, bank account, business info, custom fields, jurisdictions)
Payroll endpoints (list runs by date range, list fees, list paystubs, get paystub with earnings + deductions + employer contributions)
Deductions endpoints (list types, list, create, update, cancel) with per-row operation_id idempotency
Time Off endpoints (asynchronous balance reports, policies, requests)
Signed webhooks for member.profile.created/updated, member.employment_state.termination_scheduled/canceled, and department.created/updated/deleted
Webhook simulator endpoint for partner-listener validation in the Tour environment
24-hour access tokens and 30-day refresh tokens
Hierarchical OAuth scopes (e.g., member.detail:read implies member.basic:read implies member.dob/sex:read)
Zero-decimal currency representation for all monetary fields
Partner program with revenue share, co-marketing, dedicated relationship managers
Integrations marketplace covering Greenhouse, Lever, JazzHR, CultureAmp, 15Five, QuickBooks, NetSuite, Xero, Sage Intacct, Brex, Ramp
Available via aggregator platforms Finch, Merge, and Apideck for cross-HRIS access

Semantic Vocabularies

Justworks Context

0 classes · 8 properties

JSON-LD

Resources

🔗
Website
Website
🔗
Documentation
Documentation
🌐
Portal
Portal
🚀
GettingStarted
GettingStarted
💰
Pricing
Pricing
🔗
Products
Products
🔗
PartnerProgram
PartnerProgram
📰
PartnerBlog
PartnerBlog
🔗
HelpCenter
HelpCenter
🔗
TrustCenter
TrustCenter
📰
Blog
Blog
🔗
Careers
Careers
👥
GitHubOrganization
GitHubOrganization
🔗
LinkedIn
LinkedIn
🔗
Twitter
Twitter
👥
YouTube
YouTube
🔗
Plans
Plans
🔗
RateLimits
RateLimits
🔗
FinOps
FinOps

Sources

Raw ↑
opencollection: 1.0.0
info:
  name: Justworks Webhooks API
  version: '2026-05-25'
request:
  auth:
    type: oauth2
    flow: authorization_code
    authorizationUrl: https://secure.justworks.com/oauth/authorize
    accessTokenUrl: https://public-api.justworks.com/oauth/token
    credentials:
      clientId: '{{clientId}}'
      clientSecret: '{{clientSecret}}'
items:
- info:
    name: Webhooks
    type: folder
  items:
  - info:
      name: Justworks List Webhooks
      type: http
    http:
      method: POST
      url: https://public-api.justworks.com/v1/webhooks/get
      params:
      - name: status
        value: ''
        type: query
    docs: List webhooks registered on the installation, optionally filtered by open or closed status.
  - info:
      name: Justworks Resume Webhook
      type: http
    http:
      method: POST
      url: https://public-api.justworks.com/v1/webhooks/:webhook_id/resume
      params:
      - name: webhook_id
        value: ''
        type: path
    docs: Resume delivery on a webhook that was previously closed due to repeated failures.
  - info:
      name: Justworks Simulate Webhook
      type: http
    http:
      method: POST
      url: https://public-api.justworks.com/v1/webhooks/:webhook_id/simulate
      params:
      - name: webhook_id
        value: ''
        type: path
      body:
        type: json
        data: '{}'
    docs: Simulate webhook delivery in the Tour environment to validate the partner listener.
bundled: true