---
title: "Creates a Review process"
method: POST
path: "/api/2026-10-01/resources/performance/review_processes"
tags: ["Performance > ReviewProcess"]
---

# Creates a Review process

`POST /api/2026-10-01/resources/performance/review_processes`

## Request

- Base URL: `https://api.factorialhr.com`
- URL: `https://api.factorialhr.com/api/2026-10-01/resources/performance/review_processes`
- Auth: one of:
  - OAuth 2
    - Authorization code: `https://id.factorialhr.com/oauth/authorize`
    - Token URL: `https://id.factorialhr.com/api/oauth/token` scopes: `performance`
  - API key in header `x-api-key`

Create a new review process.

## Request body

- object
  - `author_access_id` string, required: Access identifier of the author of the review process
  - `name` string: Name of the review process
  - `description` string: A brief description of the review process
  - `reviewer_strategies` string[]: Review types that will be assigned to the review process. It'll be used to create the evaluations when the process starts
  - `target_strategy` 'all_employees' | 'by_locations' | 'by_teams' | 'by_employees' | 'manual_selection': Condition that defines the employees that will be evaluated (participants). Calculated when the review process starts
  - `arguments` string[]: IDs of target strategy groups selected
  - `ends_at` string: Date when the review process should end
  - `agreements_enabled` boolean: Action plans help track goal progress, and facilitate performance review discussions.
  - `employee_score_enabled` boolean: Include one question at the end of the review to rate participants' performance. This rating will be reflected on the results page.
  - `employee_potential_score_enabled` boolean: Include one question at the end of the review to rate participants' potential. This rating will be reflected in the 9 box grid.
  - `competencies_assessments_enabled` boolean: Assess employees based on their assigned competencies through both manager and self-reviews. Ensure roles with designated competencies are properly set up.

## Response `201`

CREATED

- PerformanceReviewProcess
  - `id` string, required: Review process ID
  - `company_id` string, required: Company ID
  - `name` string: Review process name
  - `description` string: A brief description of the review process
  - `status` 'draft' | 'scheduled' | 'starting' | 'active' | 'finished', required: Review process status
  - `target_strategy` object: Condition that defines the employees that will be evaluated (participants). Calculated when the review process starts
    - `strategy` 'all_employees' | 'by_locations' | 'by_teams' | 'by_employees' | 'manual_selection', required
    - `arguments` string[]
  - `reviewer_strategies` string[]: Review types that will be assigned to the review process. It'll be used to create the evaluations when the process starts
  - `starts_at` string: Date when the review process should start
  - `ends_at` string: Date when the review process should end
  - `start_validation_errors` string[], required: Missing or invalid information to be able to start the review process
  - `archived` boolean, required: Whether the review process is archived or not
  - `agreements_configuration` object, required: Action plans help track goal progress, and facilitate performance review discussions.
    - `enabled` boolean, required
    - `esignature_enabled` boolean, required
  - `competencies_assessments_configuration` object, required: Assess employees based on their assigned competencies through both manager and self-reviews. Ensure roles with designated competencies are properly set up.
    - `enabled` boolean, required
  - `last_bulk_reminder` string: Date when the last bulk reminder was sent

## Changes

- **2026-11-03** `83ac9aa1de50`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/factorialhr/apis/factorial-api/changes/api/2026-10-01/resources/performance/review_processes/post.md)

---

[API](https://skmtc.dev/factorialhr/apis/factorial-api.md) - [All operations](https://skmtc.dev/factorialhr/apis/factorial-api/llms.txt) - [OpenAPI document](https://skmtc.dev/factorialhr/apis/factorial-api/revisions/83ac9aa1de50?raw)