---
title: "Add commissions"
method: POST
path: "/api/files/sales/{saleGuid}/commissions"
tags: ["Sale Commissions"]
---

# Add commissions

`POST /api/files/sales/{saleGuid}/commissions`

Adds commissions to the specified sale. Returns 422 when commissions are already present, when percent and amount are both set for the same commission, when values are out of range, or when required managed fields are missing.

### Validation & Requirements
#### Required Parameters
- `saleGuid` (path, string, format=guid)
- `form` (body, object)

#### Required JSON Body Fields
- None

#### Validations
- Invalid GUID values in `*Guid`/`*Guids` fields return `422 Unprocessable Entity`.
- Invalid date values in `*date*` fields return `422 Unprocessable Entity`.
- Missing required request body returns `422 Unprocessable Entity` with `Missing request body.`.
- Additional business-rule validation may return `422` with details in the `errors` array.
- Commission percentages must be between 0 and 100, and commission amounts cannot be negative.
- Each commission entry must be percent or amount, not both.

#### Integration Requirement
- Retrieve the corresponding `...Form` endpoint immediately before write operations to get current dynamic required fields and allowed values.

## Path parameters

- `saleGuid` string, guid, required

## Request body

- AddCommissionsToSaleForm
  - `transactionCoordinatorName` string, nullable — Deprecated. Use the /transactionCoordinators endpoint for Transaction Coordinator names.
  - `transactionCoordinatorFee` number, nullable — Deprecated. Use AdminBrokerageComp instead.
  - `adminBrokerageComp` number, nullable — Admin brokerage compensation fee. Preferred over TransactionCoordinatorFee.
  - `dateOfCheck` string, date-time, nullable
  - `datePostedToLogBook` string, date-time, nullable
  - `listingCommissionPercent` number, nullable — If required, either percent or amount field needs to be filled
  - `listingCommissionAmount` number, nullable — If required, either percent or amount field needs to be filled
  - `saleCommissionPercent` number, nullable — If required, either percent or amount field needs to be filled
  - `saleCommissionAmount` number, nullable — If required, either percent or amount field needs to be filled
  - `otherDeductions` number, nullable
  - `personalDeal` boolean, nullable
  - `commissionBreakdownDetails` string, nullable

## Response `200`

- LinkedResponseOfUpdateSaleCommissionsResponse
  - `value` UpdateSaleCommissionsResponse
  - `warnings` string[], nullable
  - `links` Link[], nullable
    - `href` string, nullable
    - `rel` string, nullable
    - `method` string, nullable

## Other responses

- `404`
- `422`

---

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