# POST /affiliate/commissionrule/create — Create Commission Rule > Product: **Pabbly Subscription Billing** (v1) > Base URL: `https://payments.pabbly.com/api/v1` > Auth: Basic via `Authorization` header > Canonical: `/subscription-billing/affiliate-modules/create-commission-rule` Creates a new commission record for the affiliate in existing invoice. StartFragment . Attributes :: EndFragm **Body parameters:** | Name | Type | Required | Description | |------|------|----------|-------------| | affiliate_id | string | Yes | You can apply rules for all affiliates or for an individual affiliate. Possible values "all" or "selected_affiliates" | | product_id | string | Yes | You can add rules for all products or for individual products. Possible values "all" or "{{product_id}}" | | plan_id | string | Yes | You can apply rules for all plans or for an individual plan. Possible values "selected_plans" or "all_plans" | | plan_array | array | No | Required if the plan_id is "selected_plans". Array of plan ids | | rule_title | string | Yes | Add any commission rule name associated with your product, plan, and affiliate partner. This name is for your reference only. | | first_amount | integer | Yes | Commission for the first payment. | | first_amount_type | string | Yes | You can set the affiliate commission as a flat amount or in percentage. Possible values "flat" or "percent" | | subscription_only | boolean | No | Check if you want to apply commissions only to the subscription fee or addon fee and not to the setup fee. Possible values true or false. | | tiers | array | No | Required if no_of_tiers is greater than 0. You can set the commission rule for multi-tier affiliates either for first sale or recurring sales as well. The commission rule will always be in a percentage format. | | no_of_tiers | integer | Yes | You can set up multiple tiers by entering the number of tiers that you want to set up for your Affiliate program. Note: If you do not wish to set up the multi-tiers, keep the number of tiers as 1 by default. | | rebill_amount_type | string | Yes | You can set the affiliate commission as a flat amount or in percentage. Possible values "flat" or "percent" | | rebill_amount | integer | Yes | Commission for the second payment. | **Example request body:** ```json { "affiliate_id": "all", "product_id": "624aa3503b0ba866b0cb79ec", "plan_id": "selected_plans", "plan_array": [ "650ed0ec88166235e3811234", "64e9a8e34f908138c5099583" ], "rule_title": "console commission", "first_amount": 34, "first_amount_type": "percent", "subscription_only": true, "tiers": [ { "first_amount": 30, "rebill_amount": 10 } ], "no_of_tiers": 2, "rebill_amount_type": "percent", "rebill_amount": 12 } ``` **Response (200)** — Create Commission: ```json { "status": "success", "message": "Commission rule created", "data": { "first_amount": 34, "first_amount_type": "percent", "subscription_only": true, "tiers": [ { "first_amount": 30, "rebill_amount": 10 } ], "no_of_tiers": 2, "rebill_amount_type": "percent", "createdAt": "2023-10-11T12:10:49.433Z", "updatedAt": "2023-10-11T12:10:49.433Z", "rule_title": "console commission", "affiliate_id": "all", "product_id": "624aa3503b0ba866b0cb79ec", "plan_id": "selected_plans" } } ``` **Code examples:** _cURL_ ```curl curl -X POST https://payments.pabbly.com/api/v1/affiliate/commissionrule/create \ -u {{YOUR_API_KEY}}:{{YOUR_SECRET_KEY}} \ -H "Content-Type: application/json" \ -d '{ "affiliate_id": "all", "product_id": "624aa3503b0ba866b0cb79ec", "plan_id": "selected_plans", "plan_array": [ "650ed0ec88166235e3811234", "64e9a8e34f908138c5099583" ], "rule_title": "console commission", "first_amount": 34, "first_amount_type": "percent", "subscription_only": true, "tiers": [ { "first_amount": 30, "rebill_amount": 10 } ], "no_of_tiers": 2, "rebill_amount_type": "percent", "rebill_amount": 12 }' ``` _Ruby_ ```ruby require 'net/http' require 'json' uri = URI('https://payments.pabbly.com/api/v1/affiliate/commissionrule/create') request = Net::HTTP::Post.new(uri) request.basic_auth '{{YOUR_API_KEY}}', '{{YOUR_SECRET_KEY}}' request['Content-Type'] = 'application/json' request.body = "{\"affiliate_id\":\"all\",\"product_id\":\"624aa3503b0ba866b0cb79ec\",\"plan_id\":\"selected_plans\",\"plan_array\":[\"650ed0ec88166235e3811234\",\"64e9a8e34f908138c5099583\"],\"rule_title\":\"console commission\",\"first_amount\":34,\"first_amount_type\":\"percent\",\"subscription_only\":true,\"tiers\":[{\"first_amount\":30,\"rebill_amount\":10}],\"no_of_tiers\":2,\"rebill_amount_type\":\"percent\",\"rebill_amount\":12}" response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: uri.scheme == 'https') do |http| http.request(request) end data = JSON.parse(response.body) ``` _Python_ ```python import requests from requests.auth import HTTPBasicAuth response = requests.post( 'https://payments.pabbly.com/api/v1/affiliate/commissionrule/create', auth=HTTPBasicAuth('{{YOUR_API_KEY}}', '{{YOUR_SECRET_KEY}}'), json={ 'affiliate_id': 'all', 'product_id': '624aa3503b0ba866b0cb79ec', 'plan_id': 'selected_plans', 'plan_array': [ '650ed0ec88166235e3811234', '64e9a8e34f908138c5099583' ], 'rule_title': 'console commission', 'first_amount': 34, 'first_amount_type': 'percent', 'subscription_only': True, 'tiers': [ { 'first_amount': 30, 'rebill_amount': 10 } ], 'no_of_tiers': 2, 'rebill_amount_type': 'percent', 'rebill_amount': 12 }, ) data = response.json() ``` _PHP_ ```php response = client.send(request, HttpResponse.BodyHandlers.ofString()); System.out.println(response.body()); ``` _Node.js_ ```node const credentials = Buffer.from('{{YOUR_API_KEY}}:{{YOUR_SECRET_KEY}}').toString('base64'); const response = await fetch('https://payments.pabbly.com/api/v1/affiliate/commissionrule/create', { method: 'POST', headers: { 'Authorization': `Basic ${credentials}`, 'Content-Type': 'application/json', }, body: JSON.stringify({ "affiliate_id": "all", "product_id": "624aa3503b0ba866b0cb79ec", "plan_id": "selected_plans", "plan_array": [ "650ed0ec88166235e3811234", "64e9a8e34f908138c5099583" ], "rule_title": "console commission", "first_amount": 34, "first_amount_type": "percent", "subscription_only": true, "tiers": [ { "first_amount": 30, "rebill_amount": 10 } ], "no_of_tiers": 2, "rebill_amount_type": "percent", "rebill_amount": 12 }), }); const data = await response.json(); ``` _Go_ ```go package main import ( "fmt" "io" "net/http" "strings" ) func main() { payload := strings.NewReader("{\"affiliate_id\":\"all\",\"product_id\":\"624aa3503b0ba866b0cb79ec\",\"plan_id\":\"selected_plans\",\"plan_array\":[\"650ed0ec88166235e3811234\",\"64e9a8e34f908138c5099583\"],\"rule_title\":\"console commission\",\"first_amount\":34,\"first_amount_type\":\"percent\",\"subscription_only\":true,\"tiers\":[{\"first_amount\":30,\"rebill_amount\":10}],\"no_of_tiers\":2,\"rebill_amount_type\":\"percent\",\"rebill_amount\":12}") req, _ := http.NewRequest("POST", "https://payments.pabbly.com/api/v1/affiliate/commissionrule/create", payload) req.Header.Set("Content-Type", "application/json") req.SetBasicAuth("{{YOUR_API_KEY}}", "{{YOUR_SECRET_KEY}}") res, _ := http.DefaultClient.Do(req) defer res.Body.Close() body, _ := io.ReadAll(res.Body) fmt.Println(string(body)) } ``` _.NET_ ```dotnet using System.Net.Http; using System.Net.Http.Headers; using System.Text; using System.Threading.Tasks; var credentials = Convert.ToBase64String(Encoding.ASCII.GetBytes("{{YOUR_API_KEY}}:{{YOUR_SECRET_KEY}}")); var client = new HttpClient(); var request = new HttpRequestMessage(HttpMethod.Post, "https://payments.pabbly.com/api/v1/affiliate/commissionrule/create"); request.Headers.TryAddWithoutValidation("Authorization", $"Basic {credentials}"); request.Content = new StringContent("{\"affiliate_id\":\"all\",\"product_id\":\"624aa3503b0ba866b0cb79ec\",\"plan_id\":\"selected_plans\",\"plan_array\":[\"650ed0ec88166235e3811234\",\"64e9a8e34f908138c5099583\"],\"rule_title\":\"console commission\",\"first_amount\":34,\"first_amount_type\":\"percent\",\"subscription_only\":true,\"tiers\":[{\"first_amount\":30,\"rebill_amount\":10}],\"no_of_tiers\":2,\"rebill_amount_type\":\"percent\",\"rebill_amount\":12}"); request.Content.Headers.ContentType = new MediaTypeHeaderValue("application/json"); var response = await client.SendAsync(request); var data = await response.Content.ReadAsStringAsync(); Console.WriteLine(data); ``` --- **Other endpoints in Affiliate Modules:** - [POST /commissions/create — Create Commission](/subscription-billing/affiliate-modules/create-commission) - [GET /commissions — List Commissions](/subscription-billing/affiliate-modules/list-commissions) - [PUT /commissions/{{commissionId}} — Update Commission](/subscription-billing/affiliate-modules/update-commission) - [GET /commissions/clicks — Affiliate Clicks](/subscription-billing/affiliate-modules/affiliate-clicks) - [DELETE /commissions/clicks/{{click_id}} — Delete Clicks](/subscription-billing/affiliate-modules/delete-clicks) - [POST /affiliate/payout/generate — Create Manual Report](/subscription-billing/affiliate-modules/create-manual-report) - [GET /affiliate/links — Affiliate Links](/subscription-billing/affiliate-modules/affiliate-links) - [PUT /affiliate/status/{{id}} — Update Affiliate Status](/subscription-billing/affiliate-modules/update-affiliate-status)