---
updatedAt: 2026-05-20T09:37:17.000Z
agentTools:
  projectIndex: https://dev.gotom.io/llms.txt
---

# Set the flight's commission

Careful: Updating the campaign with a new agency/intermediator or with the same agency/intermediator will recalculate the commissions of that agency/intermediator and overwrite the flight commission set here.

Read details in the update campaign endpoint.


# OpenAPI definition

```json
{
  "openapi": "3.0.0",
  "info": {
    "version": "4.4.12",
    "title": "Campaign API"
  },
  "x-explorer-enabled": false,
  "paths": {
    "/app-api/campaign/{campaignExternalId}/flight/{flightExternalId}/commission": {
      "parameters": [
        {
          "$ref": "#/components/parameters/ParamCampaignExternalId"
        },
        {
          "$ref": "#/components/parameters/ParamFlightExternalId"
        }
      ],
      "post": {
        "tags": [
          "CampaignFlight"
        ],
        "summary": "Set the flight's commission",
        "description": "Careful: Updating the campaign with a new agency/intermediator or with the same agency/intermediator will recalculate the commissions of that agency/intermediator and overwrite the flight commission set here.\n\nRead details in the update campaign endpoint.\n",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/FlightCommission"
              }
            }
          }
        },
        "responses": {
          "204": {
            "description": "Commission was updated successfully"
          },
          "400": {
            "description": "Returns a list of errors in the input data. For this call the following violation codes can be expected\n  * `6e40c9b1-7f75-4a3a-8149-26adecd9a5d4` - Commission update failed: Please provide either a percentage or amount for the commissions but not both\n  * `504d6c75-bacb-4319-ad0a-e942a30904f7` - Error: Delta-Invoice exists\n  * `407eebae-cb0c-49fd-9708-4312452133ee` - Cannot change commission because flight is already invoiced\n"
          },
          "404": {
            "description": "The campaign does not exist"
          },
          "500": {
            "$ref": "#/components/responses/InternalServerErrorDefault"
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "FlightCommission": {
        "description": "Represents the commission values for a flight",
        "type": "object",
        "properties": {
          "bkPercent": {
            "description": "Percentage of the BK (only set either percentage or amount)",
            "type": "number",
            "example": 5
          },
          "bkAmount": {
            "description": "Amount of the BK (only set either percentage or amount)",
            "type": "number",
            "example": 120
          },
          "vmkType": {
            "description": "The type of the intermediator commission, this value will update on campaign level",
            "enum": [
              "VMK",
              "DBE"
            ],
            "type": "string"
          },
          "vmkPercent": {
            "description": "Percentage of the vmk (only set either percentage or amount)",
            "type": "number",
            "example": 12
          },
          "vmkAmount": {
            "description": "Amount of the vmk (only set either percentage or amount)",
            "type": "number",
            "example": 500
          }
        }
      },
      "InternalServerErrorResponse": {
        "properties": {
          "message": {
            "type": "string",
            "example": "Internal Server Error"
          }
        }
      }
    },
    "parameters": {
      "ParamCampaignExternalId": {
        "in": "path",
        "name": "campaignExternalId",
        "schema": {
          "type": "string"
        },
        "required": true,
        "example": "example-campaign",
        "description": "External ID of a campaign. See: [Good and Bad External IDs](/docs/good-and-bad-external-ids)"
      },
      "ParamFlightExternalId": {
        "in": "path",
        "name": "flightExternalId",
        "example": "example-flight",
        "schema": {
          "type": "string"
        },
        "required": true,
        "description": "External ID of a flight. See: [Good and Bad External IDs](/docs/good-and-bad-external-ids)"
      }
    },
    "responses": {
      "InternalServerErrorDefault": {
        "description": "If your request broke our code. Send us your request-document to reproduce the error and we'll fix it.",
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/InternalServerErrorResponse"
            }
          }
        }
      }
    }
  }
}
```