---
title: "Create override"
method: POST
path: "/affiliates/{id}/overrides"
tags: ["Affiliates"]
---

# Create override

`POST /affiliates/{id}/overrides`

Creates a commission override for an affiliate.

Required permissions:
 - `affiliate:create`

## Path parameters

- `id` string, required

## Request body

- union — Parameters for CreateAffiliateOverride
  - object — Autogenerated input type of CreateAffiliateOverride
    - `applies_to_payments` 'first_payment' | 'all_payments' — Whether the affiliate commission applies to the first payment or all payments
    - `commission_type` 'percentage' | 'flat_fee' — The types of payouts an affiliate can have
    - `commission_value` number, required — The commission value (percentage 1-100 or flat fee).
    - `id` string, required — The affiliate ID.
    - `override_type` 'standard', required
    - `plan_id` string, required — The plan ID (required for standard overrides).
  - object — Autogenerated input type of CreateAffiliateOverride
    - `commission_type` 'percentage' | 'flat_fee' — The types of payouts an affiliate can have
    - `commission_value` number, required — The commission value (percentage 1-100 or flat fee).
    - `id` string, required — The affiliate ID.
    - `override_type` 'rev_share', required
    - `product_id` string, nullable — The product ID (for rev-share overrides, omit for company-wide).
    - `revenue_basis` 'pre_fees' | 'post_fees' — The calculation method for affiliate rev-share percentages

## Response `200`

A successful response

- object — A commission configuration for an affiliate, defining payout terms for a specific plan or revenue share
  - `applies_to_payments` 'first_payment' | 'all_payments', required — Whether the affiliate commission applies to the first payment or all payments
  - `applies_to_products` 'single_product' | 'all_products', required — Whether a rev-share override applies to a single product or all products
  - `checkout_direct_link` string, nullable, required — The checkout direct link for referrals (standard overrides only).
  - `commission_type` 'percentage' | 'flat_fee', required — The types of payouts an affiliate can have
  - `commission_value` number, required — The commission amount. A percentage (1-100) when commission_type is percentage, or a dollar amount when flat_fee.
  - `id` string, required — The unique identifier for the affiliate override.
  - `override_type` 'standard' | 'rev_share', required — The role of an affiliate override (standard or rev_share)
  - `plan_id` string, nullable, required — The plan ID (for standard overrides).
  - `product_direct_link` string, nullable, required — The product page direct link for referrals (standard overrides only).
  - `product_id` string, nullable, required — The product ID (for rev-share overrides).
  - `revenue_basis` 'pre_fees' | 'post_fees', required — The calculation method for affiliate rev-share percentages
  - `total_referral_earnings_usd` number, required — The total earnings paid to this affiliate for referrals to this specific plan, in USD.

## Other responses

- `400` — Bad request
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not found
- `422` — Verification required
- `429` — Too many requests
- `500` — Internal server error

---

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