---
title: "Creates a review"
method: POST
path: "/reviews"
tags: ["reviews"]
---

# Creates a review

`POST /reviews`

## Request body

- ReviewInput
  - `reviewerId` string
  - `candidateId` string, uuid, required
  - `jobId` string, uuid, required
  - `overallRating` integer, required
  - `comment` string
  - `createdOn` string, date-time

## Response `201`

Review was created

- Review
  - `id` string, uuid
  - `candidateId` string, uuid
  - `jobId` string, uuid
  - `reviewerId` string
  - `overallRating` integer
  - `comment` string
  - `createdOn` string, date-time
  - `updatedOn` string, date-time

## Other responses

- `401` — with codes: * **NOT_AUTHORIZED_TO_ACCESS_RESOURCE** when caller is not authorized to access resource * **REVIEWER_NOT_AUTHORIZED_TO_ACCESS_RESOURCE** when reviewer is not authorized to access resource
- `403` — Forbidden to create a review
- `422` — When input validation fails or with codes: * **INVALID_OVERALL** when invalid overall * **NON_EXISTING_REVIEWER** when reviewer does not exist * **INACTIVE_OR_DELETED_REVIEWER** when reviewer is inactive or deleted * **CANDIDATE_NOT_FOUND** when candidate with given id not found * **JOB_NOT_FOUND** when job with given id not found * **APPLICATION_NOT_FOUND** when application for given candidate id and job id not found
- `500` — Unexpected error

---

[API](https://skmtc.net/smartrecruiters/apis/apply-api.md) · [All operations](https://skmtc.net/smartrecruiters/apis/apply-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/smartrecruiters/apply-api/revisions/449bdc2516c9/schema)