Create Commission Plan
Creates the scope target's next plan version. When the target already has an active plan, that version is retired in the same transaction; versions never change. Affiliate and special-link plans arrive with those records (not_available_yet). Cookie members require Hms-Company and Hms-Livemode; Idempotency-Key returns 400 invalid_request with idempotency_not_supported_for_member_routes. Bearer callers require Idempotency-Key. Agents cannot write affiliate records.
/commission_plansCreates the scope target's next plan version. When the target already has an active plan, that version is retired in the same transaction; versions never change. Affiliate and special-link plans arrive with those records (not_available_yet). Cookie members require Hms-Company and Hms-Livemode; Idempotency-Key returns 400 invalid_request with idempotency_not_supported_for_member_routes. Bearer callers require Idempotency-Key. Agents cannot write affiliate records.
In: header
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/json
application/json
curl -X POST "https://example.com/commission_plans" \ -H "Content-Type: application/json" \ -d '{ "program": "string", "scope": "program", "duration_kind": "once", "rate_kind": "percent", "initial_rate": "string" }'{ "data": { "id": "string", "livemode": true, "program_id": "string", "scope": "program", "product_id": "0d012afa-f885-4e65-aeca-37e27701e2d1", "affiliate_id": "string", "special_link_id": null, "version": 1, "status": "active", "rate_kind": "percent", "initial_rate": "string", "rebill_rate": "string", "flat_amounts": { "property1": { "initial_amount": "string", "rebill_amount": "string" }, "property2": { "initial_amount": "string", "rebill_amount": "string" } }, "uncovered_currencies": [ "string" ], "duration_kind": "once", "duration_count": 1, "eligible_line_kinds": [ "base" ], "tiers": { "count_scope": "program", "bands": [ { "min_sales": 1, "rate": "string" } ], "marginal": true }, "reward_kind": "cash", "effective_from": "2019-08-24T14:15:22Z", "retired_at": "string", "created_at": "2019-08-24T14:15:22Z" }, "request_id": "266ea41d-adf5-480b-af50-15b940c2b846"}