---
title: "Create Tiered Commission"
method: POST
path: "/networks/tieredcommissions"
tags: ["Tiered Commissions"]
---

# Create Tiered Commission

`POST /networks/tieredcommissions`

## Request body

- TieredCommissionInput — Input schema for creating or updating a tiered commission. At least one goal field (conversion_goal, event_goal, sale_amount_goal, payout_goal, or revenue_goal) must be greater than 0. If payout or revenue is enabled, the corresponding action and value fields are required.
  - `name` string, required — The name of the tiered commission.
  - `notes` string — Note for internal usage.
  - `status` 'active' | 'inactive', required — The tiered commissions status. Can either be `active` or `inactive`.
  - `start_date` string, required — Start of when rule goes into effect. This can be set to a future date.
  - `end_date` string, required — End of when rule goes into effect.
  - `period` 'daily' | 'weekly' | 'monthly' | 'quarterly' | 'global', required — The tiered commissions period. Can either be `daily`, `weekly`, `monthly`, `quarterly` or `global`.
  - `network_offer_payout_revenue_id` integer — ID of the offer payout revenue. Defaults to `0`.
  - `is_apply_all_affiliates` boolean — Whether or not you want to apply the tiered commission to all affiliates. Defaults to `false`.
  - `network_affiliate_ids` integer[] — ID of the Affiliates.
  - `network_offer_ids` integer[], required — ID of the offers.
  - `network_advertiser_ids` integer[], nullable — ID of the advertisers.
  - `is_payout_enabled` boolean, required — Whether or not you want to enable the payout settings. Defaults to `false`.
  - `payout_action` 'increase' | 'decrease' | 'flat_increase' | 'flat_decrease', required — Type of payout action. Required only if `is_payout_enabled` is true. Do not use `exact` — it will be stored as `unknown`.
  - `payout_value` number, required — The payout modifier value. Required only if `is_payout_enabled` is true. Must be greater than 0.
  - `is_revenue_enabled` boolean, required — Whether or not you want to enable the revenue. Defaults to `false`.
  - `revenue_action` 'increase' | 'decrease' | 'flat_increase' | 'flat_decrease', required — Type of revenue action. Required only if `is_revenue_enabled` is true. Do not use `exact` — it will be stored as `unknown`.
  - `revenue_value` number, required — The revenue modifier value. Required only if `is_revenue_enabled` is true. Must be greater than 0.
  - `payout_goal` integer — The payout goal of your tiered commission. Defaults to `0`.
  - `revenue_goal` integer — The revenue goal of your tiered commission. Defaults to `0`.
  - `sale_amount_goal` integer — The sale amount goal of your tiered commission. Defaults to `0`.
  - `conversion_goal` integer — The conversion goal of your tiered commission. Defaults to `0`.
  - `event_goal` integer — The event goal of your tiered commission. Defaults to `0`.
  - `relationship` object — Related entities. Pass an empty object `{}`.
  - `payout_max` integer — The maximum payout allowed. If set, must be greater than `payout_goal`. Defaults to `0` (no maximum).
  - `revenue_max` integer — The maximum revenue allowed. If set, must be greater than `revenue_goal`. Defaults to `0` (no maximum).
  - `sale_amount_max` integer — The maximum sale amount allowed. If set, must be greater than `sale_amount_goal`. Defaults to `0` (no maximum).
  - `conversion_max` integer — The maximum conversions allowed. If set, must be greater than `conversion_goal`. Defaults to `0` (no maximum).
  - `event_max` integer — The maximum events allowed. If set, must be greater than `event_goal`. Defaults to `0` (no maximum).
  - `is_retroactive_payout_enabled` boolean — Whether retroactive payout adjustments are enabled. Defaults to `false`.
  - `retroactive_payout_action` 'increase' | 'decrease' | 'flat_increase' | 'flat_decrease' | 'exact' — The retroactive payout action type. Required only if `is_retroactive_payout_enabled` is true. Supports `exact` unlike regular payout actions.
  - `retroactive_payout_value` number — The retroactive payout modifier value. Required only if `is_retroactive_payout_enabled` is true. Must be greater than 0.
  - `is_retroactive_revenue_enabled` boolean — Whether retroactive revenue adjustments are enabled. Defaults to `false`.
  - `retroactive_revenue_action` 'increase' | 'decrease' | 'flat_increase' | 'flat_decrease' | 'exact' — The retroactive revenue action type. Required only if `is_retroactive_revenue_enabled` is true. Supports `exact` unlike regular revenue actions.
  - `retroactive_revenue_value` number — The retroactive revenue modifier value. Required only if `is_retroactive_revenue_enabled` is true. Must be greater than 0.

## Response `200`

- TieredCommission — A tiered commission configuration with all computed and relational fields.
  - `network_tiered_commission_id` integer — Unique tiered commission ID.
  - `network_id` integer — Network ID.
  - `name` string — The name of the tiered commission.
  - `notes` string — Note for internal usage.
  - `status` 'active' | 'inactive' — The tiered commissions status. Can either be `active` or `inactive`.
  - `start_date` string — Start of when rule goes into effect. This can be set to a future date.
  - `end_date` string — End of when rule goes into effect.
  - `period` 'daily' | 'weekly' | 'monthly' | 'quarterly' | 'global' — The tiered commissions period. Can either be `daily`, `weekly`, `monthly`, `quarterly` or `global`.
  - `network_offer_payout_revenue_id` integer — ID of the offer payout revenue.
  - `is_apply_all_affiliates` boolean — Whether or not you want to apply the tiered commission to all affiliates. Defaults to false.
  - `network_affiliate_ids` integer[] — ID of the Affiliates.
  - `network_offer_ids` integer[] — ID of the offers.
  - `network_advertiser_ids` integer[], nullable — ID of the advertisers.
  - `is_payout_enabled` boolean — Whether or not you want to enable the payout settings. Defaults to false.
  - `payout_action` 'increase' | 'decrease' | 'flat_increase' | 'flat_decrease' | 'unknown' — Type of payout action. Note: sending `exact` will be stored as `unknown` — use only `increase`, `decrease`, `flat_increase`, or `flat_decrease`.
  - `payout_value` number — The payout modifier value. Required only if `is_payout_enabled` is true. Must be greater than 0.
  - `is_revenue_enabled` boolean — Whether or not you want to enable the revenue. Defaults to false.
  - `revenue_action` 'increase' | 'decrease' | 'flat_increase' | 'flat_decrease' | 'unknown' — Type of revenue action. Note: sending `exact` will be stored as `unknown` — use only `increase`, `decrease`, `flat_increase`, or `flat_decrease`.
  - `revenue_value` number — The revenue modifier value. Required only if `is_revenue_enabled` is true. Must be greater than 0.
  - `payout_goal` integer — The payout goal of your tiered commission.
  - `revenue_goal` integer — The revenue goal of your tiered commission.
  - `sale_amount_goal` integer — The sale amount goal of your tiered commission.
  - `conversion_goal` integer — The conversion goal of your tiered commission.
  - `event_goal` integer — The event goal of your tiered commission.
  - `relationship` object — Related entities. Always returns an empty object `{}` in practice.
  - `payout_max` integer — The maximum percentage of payout allowed.
  - `revenue_max` integer — The maximum amount of revenue allowed.
  - `sale_amount_max` integer — The maximum number of sale amount allowed.
  - `conversion_max` integer — The maximum number of conversions allowed.
  - `event_max` integer — The maximum number of events allowed.
  - `is_retroactive_payout_enabled` boolean — Whether retroactive payout adjustments are enabled.
  - `retroactive_payout_action` 'increase' | 'decrease' | 'flat_increase' | 'flat_decrease' | 'exact' | 'unknown' — The retroactive payout action type. Retroactive actions support `exact` in addition to the standard action types.
  - `retroactive_payout_value` number — The retroactive payout modifier value.
  - `retroactive_payout_type` 'blank' | 'cpc' | 'cpa' | 'cpm' | 'cps' | 'cpa_cps' | 'prv' | 'cpa_sku' | 'cps_sku' | 'cpa_cps_sku' | 'prv_sku' — The retroactive payout type.
  - `retroactive_payout_percentage` number — The retroactive payout percentage.
  - `is_retroactive_revenue_enabled` boolean — Whether retroactive revenue adjustments are enabled.
  - `retroactive_revenue_action` 'increase' | 'decrease' | 'flat_increase' | 'flat_decrease' | 'exact' | 'unknown' — The retroactive revenue action type. Retroactive actions support `exact` in addition to the standard action types.
  - `retroactive_revenue_value` number — The retroactive revenue modifier value.
  - `retroactive_revenue_type` 'blank' | 'rpc' | 'rpa' | 'rpm' | 'rps' | 'rpa_rps' | 'rpa_sku' | 'rps_sku' | 'rpa_rps_sku' — The retroactive revenue type.
  - `retroactive_revenue_percentage` number — The retroactive revenue percentage.
  - `time_created` integer — Unix timestamp of creation.
  - `time_saved` integer — Unix timestamp of last update.

---

[API](https://skmtc.net/everflow/apis/everflow-network-api-tracking-domains.md) · [All operations](https://skmtc.net/everflow/apis/everflow-network-api-tracking-domains/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/everflow/everflow-network-api-tracking-domains/revisions/39242cee0e32/schema)