---
updatedAt: 2026-10-05T10:08:20.000Z
agentTools:
projectIndex: https://apidoc.factorialhr.com/llms.txt
---
# OAuth Scopes
Scopes specify the exact level of access needed, ensuring OAuth tokens are restricted to only the required resources. They do not grant any permissions beyond what the user already has.
Each scope represents a set of resources within our API. The list of resources accessible by the generated OAuth token is strictly limited to the scopes configured in the OAuth application.
### If you are a Factorial Partner
If you have an OAuth application in production and wish to modify your scopes list, please [fill up this form](https://factorial.typeform.com/to/B2GJV4lT).
## How do scopes work
When creating an OAuth application, select the scopes your integration needs in **Settings → Advanced configuration → OAuth applications**.
These scopes will be sent through the URL when requesting the authorization code:
For production, use:
```
https://id.factorialhr.com/oauth/authorize?client_id=&redirect_uri=&response_type=code&scope=project_management%20time_tracking
```
For demo, use:
```
https://id.eu2.demo.factorial.dev/oauth/authorize?client_id=&redirect_uri=&response_type=code&scope=project_management%20time_tracking
```
Then the client will review the scopes sent though the URL and authorize/deny the app access to these.
Once the user authorizes the app to access the requested scopes, you can continue to [request the access token](https://apidoc.factorialhr.com/docs/request-an-access-token). The access token generated will be restricted to the authorized scopes.
**NOTE**: If you change the scopes in an already existing OAuth app, the already-generated tokens will become invalid so the client will need to re-authorize the app to be able to re-generate the OAuth tokens with the updated scopes list.
## Scopes list
Currently, our scopes allow both read and write actions within the resources.
| Scope | Endpoints |
| ----------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| banking | [`Banking > BankAccount`](https://apidoc.factorialhr.com/v2026-10-01/reference/get_api-2026-10-01-resources-banking-bank-accounts)
[Banking > BankAccountNumber > Upserts](https://apidoc.factorialhr.com/v2026-10-01/reference/post_webhooks-banking-bankaccountnumber-upserts)
[Banking > Transaction ](https://apidoc.factorialhr.com/v2026-10-01/reference/get_api-2026-10-01-resources-banking-transactions) |
| company\_legal\_entities | [`Companies > Legal Entities`](https://apidoc.factorialhr.com/v2026-10-01/reference/get_api-2026-10-01-resources-companies-legal-entities) |
| company\_holidays | [`Holidays > CompanyHoliday`](https://apidoc.factorialhr.com/v2026-10-01/reference/get_api-2026-10-01-resources-holidays-company-holidays) |
| company\_locations | [`Locations > Location`](https://apidoc.factorialhr.com/v2026-10-01/reference/get_api-2026-10-01-resources-locations-locations)
[Locations > WorkArea](https://apidoc.factorialhr.com/v2026-10-01/reference/get_api-2026-10-01-resources-locations-work-areas) |
| contracts | [`Contracts > Compensation`](https://apidoc.factorialhr.com/v2026-10-01/reference/get_api-2026-10-01-resources-contracts-compensations)
[Contracts > ContractTemplate](https://apidoc.factorialhr.com/v2026-10-01/reference/get_api-2026-10-01-resources-contracts-contract-templates)
[Contracts > ContractVersion](https://apidoc.factorialhr.com/v2026-10-01/reference/get_api-2026-10-01-resources-contracts-contract-versions)
[Contracts > FrenchContractType](https://apidoc.factorialhr.com/v2026-10-01/reference/get_api-2026-10-01-resources-contracts-french-contract-types)
[Contracts > GermanContractType](https://apidoc.factorialhr.com/v2026-10-01/reference/get_api-2026-10-01-resources-contracts-german-contract-types)
[Contracts > PortugueseContractType](https://apidoc.factorialhr.com/v2026-10-01/reference/get_api-2026-10-01-resources-contracts-portuguese-contract-types)
[Contracts > ReferenceContract](https://apidoc.factorialhr.com/v2026-10-01/reference/get_api-2026-10-01-resources-contracts-reference-contracts)
[Contracts > SpanishContractType](https://apidoc.factorialhr.com/v2026-10-01/reference/get_api-2026-10-01-resources-contracts-spanish-contract-types)
[Contracts > SpanishEducationLevel](https://apidoc.factorialhr.com/v2026-10-01/reference/get_api-2026-10-01-resources-contracts-spanish-education-levels)
[Contracts > SpanishProfessionalCategory](https://apidoc.factorialhr.com/v2026-10-01/reference/get_api-2026-10-01-resources-contracts-spanish-professional-categories)
[Contracts > Taxonomy](https://apidoc.factorialhr.com/v2026-10-01/reference/get_api-2026-10-01-resources-contracts-taxonomies) |
| custom\_fields | [`CustomFields > Field`](https://apidoc.factorialhr.com/v2026-10-01/reference/get_api-2026-10-01-resources-custom-fields-fields)
[CustomFields > Option](https://apidoc.factorialhr.com/v2026-10-01/reference/get_api-2026-10-01-resources-custom-fields-options)
[CustomFields > ResourceField](https://apidoc.factorialhr.com/v2026-10-01/reference/get_api-2026-10-01-resources-custom-fields-resource-fields)
[CustomFields > Value](https://apidoc.factorialhr.com/v2026-10-01/reference/get_api-2026-10-01-resources-custom-fields-values)
[CustomResources > Schema](https://apidoc.factorialhr.com/v2026-10-01/reference/get_api-2026-10-01-resources-custom-resources-schemas)
[CustomResources > Value](https://apidoc.factorialhr.com/v2026-10-01/reference/get_api-2026-10-01-resources-custom-resources-values) |
| documents | [`Documents > Document`](https://apidoc.factorialhr.com/v2026-10-01/reference/get_api-2026-10-01-resources-documents-documents)
[Documents > DownloadUrl](https://apidoc.factorialhr.com/v2026-10-01/reference/post_api-2026-10-01-resources-documents-download-urls-bulk-create) |
| employees | [`Employees > Employee`](https://apidoc.factorialhr.com/v2026-10-01/reference/get_api-2026-10-01-resources-employees-employees)
[Teams > Membership](https://apidoc.factorialhr.com/v2026-10-01/reference/get_api-2026-10-01-resources-teams-memberships)
[Teams > Team](https://apidoc.factorialhr.com/v2026-10-01/reference/get_api-2026-10-01-resources-teams-teams) |
| employee\_updates | [`BookkeepersManagement > Incidence`](https://apidoc.factorialhr.com/v2026-10-01/reference/get_api-2026-10-01-resources-bookkeepers-management-incidences)
[EmployeeUpdates > Absence](https://apidoc.factorialhr.com/v2026-10-01/reference/get_api-2026-10-01-resources-employee-updates-absences)
[EmployeeUpdates > ContractChange](https://apidoc.factorialhr.com/v2026-10-01/reference/get_api-2026-10-01-resources-employee-updates-contract-changes)
[EmployeeUpdates > NewHire](https://apidoc.factorialhr.com/v2026-10-01/reference/get_api-2026-10-01-resources-employee-updates-new-hires)
[EmployeeUpdates > PersonalChange](https://apidoc.factorialhr.com/v2026-10-01/reference/get_api-2026-10-01-resources-employee-updates-personal-changes)
[EmployeeUpdates > Summary](https://apidoc.factorialhr.com/v2026-10-01/reference/get_api-2026-10-01-resources-employee-updates-summaries)
[EmployeeUpdates > Termination](https://apidoc.factorialhr.com/v2026-10-01/reference/get_api-2026-10-01-resources-employee-updates-terminations) |
| expenses | [`Expenses > Expensable`](https://apidoc.factorialhr.com/v2026-10-01/reference/get_api-2026-10-01-resources-expenses-expensables)
[Expenses > Expense](https://apidoc.factorialhr.com/v2026-10-01/reference/get_api-2026-10-01-resources-expenses-expenses)
[Expenses > Milage](https://apidoc.factorialhr.com/v2026-10-01/reference/get_api-2026-10-01-resources-expenses-mileages)
[Expenses > PerDiem](https://apidoc.factorialhr.com/v2026-10-01/reference/get_api-2026-10-01-resources-expenses-per-diems) |
| finance | [`Finance > Account`](https://apidoc.factorialhr.com/v2026-10-01/reference/get_api-2026-10-01-resources-finance-accounts)
[Finance > AccountSetting](https://apidoc.factorialhr.com/v2026-10-01/reference/get_api-2026-10-01-resources-finance-accounting-settings)
[Finance > Contact](https://apidoc.factorialhr.com/v2026-10-01/reference/get_api-2026-10-01-resources-finance-contacts)
[Finance > CostCenter](https://apidoc.factorialhr.com/v2026-10-01/reference/get_api-2026-10-01-resources-finance-cost-centers)
[Finance > CostCenterMembership](https://apidoc.factorialhr.com/v2026-10-01/reference/get_api-2026-10-01-resources-finance-cost-center-memberships)
[Finance > FinancialDocument](https://apidoc.factorialhr.com/v2026-10-01/reference/get_api-2026-10-01-resources-finance-financial-documents)
[Finance > JournalEntry](https://apidoc.factorialhr.com/v2026-10-01/reference/get_api-2026-10-01-resources-finance-journal-entries)
[Finance > JournalLine](https://apidoc.factorialhr.com/v2026-10-01/reference/get_api-2026-10-01-resources-finance-journal-lines)
[Finance > TaxRate](https://apidoc.factorialhr.com/v2026-10-01/reference/get_api-2026-10-01-resources-finance-tax-rates)
[Finance > TaxType](https://apidoc.factorialhr.com/v2026-10-01/reference/get_api-2026-10-01-resources-finance-tax-types) |
| integrations | [`PayrollIntegrationsBase > Code`](https://apidoc.factorialhr.com/v2026-10-01/reference/get_api-2026-10-01-resources-payroll-integrations-base-codes) |
| job\_catalog | [`JobCatalog > Level`](https://apidoc.factorialhr.com/v2026-10-01/reference/get_api-2026-10-01-resources-job-catalog-levels)
[JobCatalog > Role](https://apidoc.factorialhr.com/v2026-10-01/reference/get_api-2026-10-01-resources-job-catalog-roles) |
| marketplace | [`Marketplace > InstallationSettings`](https://apidoc.factorialhr.com/v2026-10-01/reference/get_api-2026-10-01-resources-marketplace-installation-settings) |
| payroll | [`Payroll > FamilySituations`](https://apidoc.factorialhr.com/v2026-10-01/reference/get_api-2026-10-01-resources-payroll-family-situations)
[Payroll > PolicyPeriod](https://apidoc.factorialhr.com/v2026-10-01/reference/post_api-2026-10-01-resources-payroll-policy-periods-change-status)
[PayrollEmployees > Identifier](https://apidoc.factorialhr.com/v2026-10-01/reference/get_api-2026-10-01-resources-payroll-employees-identifiers) |
| payroll\_supplements | [`Payroll > Supplement`](https://apidoc.factorialhr.com/v2026-10-01/reference/get_api-2026-10-01-resources-payroll-supplements) |
| performance | [`Performance > Agreement`](https://apidoc.factorialhr.com/v2026-10-01/reference/get_api-2026-10-01-resources-performance-agreements)
[Performance > CompanyEmployeeScoreScale](https://apidoc.factorialhr.com/v2026-10-01/reference/get_api-2026-10-01-resources-performance-company-employee-score-scales)
[Performance > EmployeeScoreScale](https://apidoc.factorialhr.com/v2026-10-01/reference/get_api-2026-10-01-resources-performance-employee-score-scales)
[Performance > ReviewEmployeeScore](https://apidoc.factorialhr.com/v2026-10-01/reference/get_api-2026-10-01-resources-performance-review-employee-scores)
[Performance > ReviewEvaluation](https://apidoc.factorialhr.com/v2026-10-01/reference/get_api-2026-10-01-resources-performance-review-evaluations)
[Performance > ReviewEvaluationAnswer](https://apidoc.factorialhr.com/v2026-10-01/reference/get_api-2026-10-01-resources-performance-review-evaluation-answers)
[Performance > ReviewOwner](https://apidoc.factorialhr.com/v2026-10-01/reference/get_api-2026-10-01-resources-performance-review-owners)
[Performance > ReviewProcess](https://apidoc.factorialhr.com/v2026-10-01/reference/get_api-2026-10-01-resources-performance-review-processes)
[Performance > ReviewEstimatedTarget](https://apidoc.factorialhr.com/v2026-10-01/reference/get_api-2026-10-01-resources-performance-review-process-estimated-targets)
[Performance > ReviewProcessTarget](https://apidoc.factorialhr.com/v2026-10-01/reference/get_api-2026-10-01-resources-performance-review-process-targets)
[Performance > ReviewQuestionnarieByStrategy](https://apidoc.factorialhr.com/v2026-10-01/reference/get_api-2026-10-01-resources-performance-review-questionnaire-by-strategies)
[Performance > ReviewVisibilitySetting](https://apidoc.factorialhr.com/v2026-10-01/reference/get_api-2026-10-01-resources-performance-review-visibility-settings)
[Performance > TargetManager](https://apidoc.factorialhr.com/v2026-10-01/reference/get_api-2026-10-01-resources-performance-target-managers) |
| posts | [`Posts > Comment`](https://apidoc.factorialhr.com/v2026-10-01/reference/get_api-2026-10-01-resources-posts-comments)
[Posts > Group](https://apidoc.factorialhr.com/v2026-10-01/reference/get_api-2026-10-01-resources-posts-groups)
[Posts > Post](https://apidoc.factorialhr.com/v2026-10-01/reference/get_api-2026-10-01-resources-posts-posts) |
| project\_management\_expenses | [`ProjectManagement > ExpenseRecord`](https://apidoc.factorialhr.com/v2026-10-01/reference/get_api-2026-10-01-resources-project-management-expense-records)
[ProjectManagement > ExportableExpense](https://apidoc.factorialhr.com/v2026-10-01/reference/get_api-2026-10-01-resources-project-management-exportable-expenses)
[ProjectManagement > ExportableProject](https://apidoc.factorialhr.com/v2026-10-01/reference/get_api-2026-10-01-resources-project-management-exportable-projects) |
| project\_management\_projects | [`ProjectManagement > Project`](https://apidoc.factorialhr.com/v2026-10-01/reference/get_api-2026-10-01-resources-project-management-projects)
[ProjectManagement > ProjectTask](https://apidoc.factorialhr.com/v2026-10-01/reference/get_api-2026-10-01-resources-project-management-project-tasks)
[ProjectManagement > ProjectWorker](https://apidoc.factorialhr.com/v2026-10-01/reference/get_api-2026-10-01-resources-project-management-project-workers)
[ProjectManagement > Subproject](https://apidoc.factorialhr.com/v2026-10-01/reference/get_api-2026-10-01-resources-project-management-subprojects) |
| project\_management\_time | [`ProjectManagement > FlexibleTimeRecord`](https://apidoc.factorialhr.com/v2026-10-01/reference/get_api-2026-10-01-resources-project-management-flexible-time-records)
[ProjectManagement > FlexibleTimeRecordComment](https://apidoc.factorialhr.com/v2026-10-01/reference/get_api-2026-10-01-resources-project-management-flexible-time-record-comments)
[ProjectManagement > TimeRecord](https://apidoc.factorialhr.com/v2026-10-01/reference/get_api-2026-10-01-resources-project-management-time-records) |
| shift\_management | [`ShiftManagement > Shift`](https://apidoc.factorialhr.com/v2026-10-01/reference/get_api-2026-10-01-resources-shift-management-shifts) |
| tasks | [`Tasks > Task`](https://apidoc.factorialhr.com/v2026-10-01/reference/get_api-2026-10-01-resources-tasks-tasks)
[Tasks > TaskFile](https://apidoc.factorialhr.com/v2026-10-01/reference/get_api-2026-10-01-resources-tasks-task-files) |
| time\_off | [`Timeoff > Allowance`](https://apidoc.factorialhr.com/v2026-10-01/reference/get_api-2026-10-01-resources-timeoff-allowances)
[Timeoff > AllowanceIncidence](https://apidoc.factorialhr.com/v2026-10-01/reference/get_api-2026-10-01-resources-timeoff-allowance-incidences)
[Timeoff > AllowanceStat](https://apidoc.factorialhr.com/v2026-10-01/reference/get_api-2026-10-01-resources-timeoff-allowance-stats)
[Timeoff > BlockedPeriod](https://apidoc.factorialhr.com/v2026-10-01/reference/get_api-2026-10-01-resources-timeoff-blocked-periods)
[Timeoff > Leave](https://apidoc.factorialhr.com/v2026-10-01/reference/get_api-2026-10-01-resources-timeoff-leaves)
[Timeoff > LeaveType](https://apidoc.factorialhr.com/v2026-10-01/reference/get_api-2026-10-01-resources-timeoff-leave-types)
[Timeoff > Policy](https://apidoc.factorialhr.com/v2026-10-01/reference/get_api-2026-10-01-resources-timeoff-policies)
[Timeoff > PolicyAssignment](https://apidoc.factorialhr.com/v2026-10-01/reference/get_api-2026-10-01-resources-timeoff-policy-assignments)
[Timeoff > PolicyTimeline](https://apidoc.factorialhr.com/v2026-10-01/reference/get_api-2026-10-01-resources-timeoff-policy-timelines) |
| time\_tracking | [`Attendance > BreakConfiguration`](https://apidoc.factorialhr.com/v2026-10-01/reference/get_api-2026-10-01-resources-attendance-break-configurations)
[Attendance > EditTimesheetRequest](https://apidoc.factorialhr.com/v2026-10-01/reference/get_api-2026-10-01-resources-attendance-edit-timesheet-requests)
[Attendance > EstimatedTime](https://apidoc.factorialhr.com/v2026-10-01/reference/get_api-2026-10-01-resources-attendance-estimated-times)
[Attendance > OpenShift](https://apidoc.factorialhr.com/v2026-10-01/reference/get_api-2026-10-01-resources-attendance-open-shifts)
[Attendance > OvertimeRequest](https://apidoc.factorialhr.com/v2026-10-01/reference/get_api-2026-10-01-resources-attendance-overtime-requests)
[Attendance > Shift](https://apidoc.factorialhr.com/v2026-10-01/reference/get_api-2026-10-01-resources-attendance-shifts)
[Attendance > WorkedTime](https://apidoc.factorialhr.com/v2026-10-01/reference/get_api-2026-10-01-resources-attendance-worked-times)
[TimePlanning > PlanningVersion](https://apidoc.factorialhr.com/v2026-10-01/reference/get_api-2026-10-01-resources-time-planning-planning-versions)
[TimeSettings > BreakConfiguration](https://apidoc.factorialhr.com/v2026-10-01/reference/get_api-2026-10-01-resources-time-settings-break-configurations)
[WorkSchedule > DayConfiguration](https://apidoc.factorialhr.com/v2026-10-01/reference/get_api-2026-10-01-resources-work-schedule-day-configurations)
[WorkSchedule > OverlapPeriod](https://apidoc.factorialhr.com/v2026-10-01/reference/get_api-2026-10-01-resources-work-schedule-overlap-periods)
[WorkSchedule > Schedule](https://apidoc.factorialhr.com/v2026-10-01/reference/get_api-2026-10-01-resources-work-schedule-schedules) |
| trainings | [`Trainings > Category`](https://apidoc.factorialhr.com/v2026-10-01/reference/get_api-2026-10-01-resources-trainings-categories)
[Trainings > Session](https://apidoc.factorialhr.com/v2026-10-01/reference/get_api-2026-10-01-resources-trainings-sessions)
[Trainings > SessionAccessMembership](https://apidoc.factorialhr.com/v2026-10-01/reference/get_api-2026-10-01-resources-trainings-session-access-memberships)
[Trainings > SessionAttendance](https://apidoc.factorialhr.com/v2026-10-01/reference/get_api-2026-10-01-resources-trainings-session-attendances)
[Trainings > Training](https://apidoc.factorialhr.com/v2026-10-01/reference/get_api-2026-10-01-resources-trainings-trainings)
[Trainings > TrainingMembership](https://apidoc.factorialhr.com/v2026-10-01/reference/get_api-2026-10-01-resources-trainings-training-memberships) |
| recruitment | [`Ats > Answer`](https://apidoc.factorialhr.com/v2026-10-01/reference/get_api-2026-10-01-resources-ats-answers)
[Ats > Application](https://apidoc.factorialhr.com/v2026-10-01/reference/get_api-2026-10-01-resources-ats-applications)
[Ats > ApplicationPhase](https://apidoc.factorialhr.com/v2026-10-01/reference/get_api-2026-10-01-resources-ats-application-phases)
[Ats > Candidate](https://apidoc.factorialhr.com/v2026-10-01/reference/get_api-2026-10-01-resources-ats-candidates)
[Ats > CandidateSource](https://apidoc.factorialhr.com/v2026-10-01/reference/get_api-2026-10-01-resources-ats-candidate-sources)
[Ats > EvaluationForm](https://apidoc.factorialhr.com/v2026-10-01/reference/get_api-2026-10-01-resources-ats-evaluation-forms)
[Ats > Feedback](https://apidoc.factorialhr.com/v2026-10-01/reference/get_api-2026-10-01-resources-ats-feedbacks)
[Ats > HiringStage](https://apidoc.factorialhr.com/v2026-10-01/reference/get_api-2026-10-01-resources-ats-hiring-stages)
[Ats > JobPosting](https://apidoc.factorialhr.com/v2026-10-01/reference/get_api-2026-10-01-resources-ats-job-postings)
[Ats > Message](https://apidoc.factorialhr.com/v2026-10-01/reference/get_api-2026-10-01-resources-ats-messages)
[Ats > Question](https://apidoc.factorialhr.com/v2026-10-01/reference/get_api-2026-10-01-resources-ats-questions)
[Ats > RejectionReason](https://apidoc.factorialhr.com/v2026-10-01/reference/get_api-2026-10-01-resources-ats-rejection-reasons) |