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

# Create one

`POST /v1/erp/payouts/reviews`

## Request

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

Creates a new review

## Parameters

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

## Request body

- Review
  - `id` string, uuid
  - `kind` 'comment' | 'file' | 'approval' | 'change_request', required
  - `company_id` string, uuid, required
  - `user_id` string, uuid: The id of the user that created the review. Always set server-side to the authenticated user; any value sent by the client is ignored.
  - `user` object: Embedded author. Present on the list (index) response.
    - `id` string, uuid, required
    - `first_name` string, required
    - `last_name` string, required
    - `identifier` string, required: The identifier of the user. This can be a rut, passport number, etc.
    - `email` string, required
    - `created_at` string, date-time
    - `updated_at` string, date-time
  - `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`.
  - `body` string, required
  - `created_at` string, date-time
  - `updated_at` string, date-time

## Response `201`

Body of the created review. The `user` author embed is only present on the list (index) response, not here.

- Review
  - `id` string, uuid
  - `kind` 'comment' | 'file' | 'approval' | 'change_request', required
  - `company_id` string, uuid, required
  - `user_id` string, uuid: The id of the user that created the review. Always set server-side to the authenticated user; any value sent by the client is ignored.
  - `user` object: Embedded author. Present on the list (index) response.
    - `id` string, uuid, required
    - `first_name` string, required
    - `last_name` string, required
    - `identifier` string, required: The identifier of the user. This can be a rut, passport number, etc.
    - `email` string, required
    - `created_at` string, date-time
    - `updated_at` string, date-time
  - `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`.
  - `body` string, required
  - `created_at` string, date-time
  - `updated_at` string, date-time

## Other responses

- `401`: Unauthorized
- `422`: Unprocessable Entity

---

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