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

# Add commissions (V2)

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

## Request

- Base URL: `https://api.skyslope.com`
- URL: `https://api.skyslope.com/api/v2/files/sales/{saleGuid}/commissions`
- Auth: OpenID Connect (`https://example.com/.well-known/openid-configuration`)

Adds commissions to the specified sale, using V2 managed fields.

### 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.

## 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.dev/skyslope/apis/skyslope-api.md) - [All operations](https://skmtc.dev/skyslope/apis/skyslope-api/llms.txt) - [OpenAPI document](https://skmtc.dev/skyslope/apis/skyslope-api/revisions/77341f0c0550?raw)