---
title: "Create one"
method: POST
path: "/v1/erp/payouts/reviewers"
tags: ["Reviewer"]
---

# Create one

`POST /v1/erp/payouts/reviewers`

## Request

- Base URL: `https://api.cardda.com`
- URL: `https://api.cardda.com/v1/erp/payouts/reviewers`
- Auth: HTTP bearer

Creates a new reviewer

## Parameters

- `#/paths/~1v1~1erp~1payouts~1rules/get/parameters/0` (unresolved $ref)

## Request body

- object
  - `role` 'reviewer' | 'approver'
  - `source_id` string, uuid, required: The id of the object being reviewed (payable or purchase order).
  - `source_type` string, required: The polymorphic type of the object being reviewed, e.g. `Erp::Payouts::Payable` or `Erp::Payouts::PurchaseOrder`.
  - `company_id` string, uuid, required
  - `user_id` string, uuid, required

## Response `201`

Body of the created reviewer.

- Reviewer
  - `id` string, uuid, required
  - `company_id` string, uuid, required
  - `user_id` string, uuid, required: The id of the user that is the reviewer.
  - `source_id` string, uuid, required: The id of the object being reviewed (payable or purchase order).
  - `source_type` string, required: The polymorphic type of the object being reviewed, e.g. `Erp::Payouts::Payable` or `Erp::Payouts::PurchaseOrder`.
  - `level` integer: The approval level of this reviewer in the review chain.
  - `enabled` boolean: Whether this reviewer is currently active in the review chain.
  - `approved` boolean: Whether this reviewer has approved. Derived server-side; not modifiable through the endpoints.
  - `current_status` 'comment' | 'file' | 'approval' | 'change_request': The current status of the review. This is not modifiable using the endpoints.
  - `user` User (unresolved $ref)
  - `role` string
  - `created_at` string, date-time
  - `updated_at` string, date-time

## Other responses

- `401`: Unauthorized
- `422`: Unprocessable Entity — validation failed. When the assigned reviewer's level is below the minimum, `error_code` is `reviewers/level_too_low`.

---

[API](https://skmtc.dev/cardda/apis/banking-api.md) - [All operations](https://skmtc.dev/cardda/apis/banking-api/llms.txt) - [OpenAPI document](https://skmtc.dev/cardda/apis/banking-api/revisions/ff1aeb3fda8b?raw)