Justworks · OAuth Scopes

Justworks OAuth Scopes

OAuth 2.0 derived

Justworks publishes 15 OAuth 2.0 scopes via the authorizationCode flow. Scopes are the fine-grained permissions an application requests at authorization time to act against the Justworks API on a user’s behalf.

Tokens are issued from https://public-api.justworks.com/oauth/token.

This index is generated from the provider’s OpenAPI security definitions (and, where available, its documented scope reference) and refreshes on every APIs.io network build. Browse every provider’s scopes at scopes.apis.io.

PEOPayrollHRHuman ResourcesBenefitsHealth Insurance401(k)Time OffComplianceSmall BusinessEmployer of RecordHRIS
Scopes: 15 Flows: authorizationCode Method: derived

OAuth endpoints

Authorization URL
https://secure.justworks.com/oauth/authorize
Token URL
https://public-api.justworks.com/oauth/token
Flows
authorizationCode

Scopes (15)

ScopeDescriptionFlows
company.bank_account:read Read company bank account on file authorizationCode
company.basic:read Read basic company data authorizationCode
company.detail:read Read detailed company data authorizationCode
deductions:read Read deductions authorizationCode
deductions:write Create, update, and cancel deductions authorizationCode
member.basic:read Read basic member profile fields authorizationCode
member.detail:read Read detailed member profile including history authorizationCode
member.dob:read Read date of birth authorizationCode
member.employment:read Read employment records authorizationCode
member.pay:read Read pay history authorizationCode
member.sex:read Read sex assigned at birth authorizationCode
member.tax_id:read Read U.S. tax identifier (SSN) authorizationCode
payroll:read Read payroll runs and fees authorizationCode
paystub:read Read paystub detail authorizationCode
time_off:read Read time-off policies, balances, and requests authorizationCode

Source

OAuth Scopes

justworks-scopes.yml Raw ↑
generated: '2026-07-11'
method: derived
source: openapi/justworks-company-api-openapi.yml, openapi/justworks-deductions-api-openapi.yml,
  openapi/justworks-members-api-openapi.yml, openapi/justworks-payroll-api-openapi.yml, openapi/justworks-time-off-api-openapi.yml,
  openapi/justworks-webhooks-api-openapi.yml
schemes:
- name: OAuth2
  source: openapi/justworks-company-api-openapi.yml
  flows:
  - flow: authorizationCode
    authorizationUrl: https://secure.justworks.com/oauth/authorize
    tokenUrl: https://public-api.justworks.com/oauth/token
- name: OAuth2
  source: openapi/justworks-deductions-api-openapi.yml
  flows:
  - flow: authorizationCode
    authorizationUrl: https://secure.justworks.com/oauth/authorize
    tokenUrl: https://public-api.justworks.com/oauth/token
- name: OAuth2
  source: openapi/justworks-members-api-openapi.yml
  flows:
  - flow: authorizationCode
    authorizationUrl: https://secure.justworks.com/oauth/authorize
    tokenUrl: https://public-api.justworks.com/oauth/token
- name: OAuth2
  source: openapi/justworks-payroll-api-openapi.yml
  flows:
  - flow: authorizationCode
    authorizationUrl: https://secure.justworks.com/oauth/authorize
    tokenUrl: https://public-api.justworks.com/oauth/token
- name: OAuth2
  source: openapi/justworks-time-off-api-openapi.yml
  flows:
  - flow: authorizationCode
    authorizationUrl: https://secure.justworks.com/oauth/authorize
    tokenUrl: https://public-api.justworks.com/oauth/token
- name: OAuth2
  source: openapi/justworks-webhooks-api-openapi.yml
  flows:
  - flow: authorizationCode
    authorizationUrl: https://secure.justworks.com/oauth/authorize
    tokenUrl: https://public-api.justworks.com/oauth/token
scopes:
- scope: company.bank_account:read
  description: Read company bank account on file
  flows:
  - authorizationCode
  sources:
  - openapi/justworks-company-api-openapi.yml
- scope: company.basic:read
  description: Read basic company data
  flows:
  - authorizationCode
  sources:
  - openapi/justworks-company-api-openapi.yml
- scope: company.detail:read
  description: Read detailed company data
  flows:
  - authorizationCode
  sources:
  - openapi/justworks-company-api-openapi.yml
- scope: deductions:read
  description: Read deductions
  flows:
  - authorizationCode
  sources:
  - openapi/justworks-deductions-api-openapi.yml
- scope: deductions:write
  description: Create, update, and cancel deductions
  flows:
  - authorizationCode
  sources:
  - openapi/justworks-deductions-api-openapi.yml
- scope: member.basic:read
  description: Read basic member profile fields
  flows:
  - authorizationCode
  sources:
  - openapi/justworks-members-api-openapi.yml
- scope: member.detail:read
  description: Read detailed member profile including history
  flows:
  - authorizationCode
  sources:
  - openapi/justworks-members-api-openapi.yml
- scope: member.dob:read
  description: Read date of birth
  flows:
  - authorizationCode
  sources:
  - openapi/justworks-members-api-openapi.yml
- scope: member.employment:read
  description: Read employment records
  flows:
  - authorizationCode
  sources:
  - openapi/justworks-members-api-openapi.yml
- scope: member.pay:read
  description: Read pay history
  flows:
  - authorizationCode
  sources:
  - openapi/justworks-members-api-openapi.yml
- scope: member.sex:read
  description: Read sex assigned at birth
  flows:
  - authorizationCode
  sources:
  - openapi/justworks-members-api-openapi.yml
- scope: member.tax_id:read
  description: Read U.S. tax identifier (SSN)
  flows:
  - authorizationCode
  sources:
  - openapi/justworks-members-api-openapi.yml
- scope: payroll:read
  description: Read payroll runs and fees
  flows:
  - authorizationCode
  sources:
  - openapi/justworks-payroll-api-openapi.yml
- scope: paystub:read
  description: Read paystub detail
  flows:
  - authorizationCode
  sources:
  - openapi/justworks-payroll-api-openapi.yml
- scope: time_off:read
  description: Read time-off policies, balances, and requests
  flows:
  - authorizationCode
  sources:
  - openapi/justworks-time-off-api-openapi.yml