Documentation version: 2026-11-16.2
Canonical: https://docs.creator.gg/tools/affiliate_commissions_create.md

# affiliate_commissions_create

Record a manual commission for an owned referred customer. amount is the base for configured commission rules, not necessarily the amount owed. This changes financial records but does not transfer funds. Requires a stable requestId; reuse only for identical retries. Reconcile unknown effects before any new action.

## Execution

Call this MCP tool at https://mcp.creator.gg/mcp. The connection selects the workspace. A tool name is not a REST route.

Effect: changes workspace data. requestId is required by the service (8–128 characters); reuse it only for the same action and arguments.
This action has destructive or external-delivery effects. Resolve the user's requested scope before execution.


## Example arguments

Examples illustrate the schema. Replace placeholder IDs with workspace IDs and recalculate dates. For mutations, use a new requestId for each new action and retain it for identical retries.

```json
{
  "affiliateId": "affiliate_example",
  "campaignId": "campaign_example",
  "customerId": "customer_example",
  "amount": 100,
  "currency": "USD",
  "confirmCommissionChange": true,
  "requestId": "example-affiliate_commissions_create-001"
}
```

## Input schema

Generated from the executable tool contract. The behavior notes and related guide cover rules that JSON Schema cannot express.

```json
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "affiliateId": {
      "type": "string",
      "minLength": 1,
      "maxLength": 300,
      "pattern": "^[A-Za-z0-9_-]+$"
    },
    "campaignId": {
      "type": "string",
      "minLength": 1,
      "maxLength": 300,
      "pattern": "^[A-Za-z0-9_-]+$"
    },
    "customerId": {
      "type": "string",
      "minLength": 1,
      "maxLength": 300,
      "pattern": "^[A-Za-z0-9_-]+$"
    },
    "amount": {
      "type": "number",
      "minimum": 0
    },
    "currency": {
      "type": "string",
      "enum": [
        "USD",
        "CAD",
        "EUR",
        "AED",
        "AFN",
        "ALL",
        "AMD",
        "ARS",
        "AUD",
        "AZN",
        "BAM",
        "BBD",
        "BDT",
        "BGN",
        "BHD",
        "BIF",
        "BMD",
        "BND",
        "BOB",
        "BRL",
        "BWP",
        "BYR",
        "BZD",
        "CDF",
        "CHF",
        "CLP",
        "CNY",
        "COP",
        "CRC",
        "CVE",
        "CZK",
        "DJF",
        "DKK",
        "DOP",
        "DZD",
        "EEK",
        "EGP",
        "ERN",
        "ETB",
        "GBP",
        "GEL",
        "GHS",
        "GNF",
        "GTQ",
        "HKD",
        "HNL",
        "HRK",
        "HUF",
        "IDR",
        "ILS",
        "INR",
        "IQD",
        "IRR",
        "ISK",
        "JMD",
        "JOD",
        "JPY",
        "KGS",
        "KES",
        "KHR",
        "KMF",
        "KRW",
        "KWD",
        "KZT",
        "LBP",
        "LKR",
        "LTL",
        "LVL",
        "LYD",
        "MAD",
        "MDL",
        "MGA",
        "MKD",
        "MMK",
        "MOP",
        "MUR",
        "MXN",
        "MYR",
        "MZN",
        "NAD",
        "NGN",
        "NIO",
        "NOK",
        "NPR",
        "NZD",
        "OMR",
        "PAB",
        "PEN",
        "PHP",
        "PKR",
        "PLN",
        "PYG",
        "QAR",
        "RON",
        "RSD",
        "RUB",
        "RWF",
        "SAR",
        "SDG",
        "SEK",
        "SGD",
        "SOS",
        "SRD",
        "SYP",
        "THB",
        "TND",
        "TOP",
        "TRY",
        "TTD",
        "TWD",
        "TZS",
        "UAH",
        "UGX",
        "UYU",
        "UZS",
        "VEF",
        "VND",
        "VUV",
        "XAF",
        "XCD",
        "XOF",
        "YER",
        "ZAR",
        "ZMK",
        "CUP",
        "KPW",
        "MRO",
        "ANG",
        "STN",
        "TMT",
        "ZWD",
        "KYD",
        "WST",
        "AWG",
        "AOA",
        "BSD",
        "BYN",
        "FJD",
        "FKP",
        "GIP",
        "GMD",
        "GYD",
        "HTG",
        "LAK",
        "LRD",
        "LSL",
        "MNT",
        "MVR",
        "MWK",
        "PGK",
        "SCR",
        "SHP",
        "SLE",
        "STD",
        "SZL",
        "TJS",
        "XPF",
        "ZMW"
      ]
    },
    "description": {
      "type": "string",
      "maxLength": 1000
    },
    "eventDate": {
      "type": "string",
      "format": "date-time",
      "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"
    },
    "eventId": {
      "type": "string",
      "minLength": 1,
      "maxLength": 300,
      "pattern": "^[A-Za-z0-9_-]+$"
    },
    "confirmCommissionChange": {
      "type": "boolean",
      "const": true
    },
    "requestId": {
      "type": "string",
      "pattern": "^[A-Za-z0-9_.:-]{8,128}$"
    }
  },
  "required": [
    "affiliateId",
    "campaignId",
    "customerId",
    "amount",
    "currency",
    "confirmCommissionChange",
    "requestId"
  ],
  "additionalProperties": false
}
```

## Result interpretation

Inspect status, message and operation-specific data; list and record shapes vary. A completed read or accepted request does not prove delivery or publication. Reconcile unknown outcomes. HUMAN_ACTION_REQUIRED returns instructions without performing the action.

## Related guides

- [affiliate-manager](https://docs.creator.gg/guides/affiliate-manager.md)
- [Recovery](https://docs.creator.gg/guides/recovery.md)


## Import and sync data

For initial import/backfill or ongoing ingestion of new users/people, companies and many-to-many memberships, read [Import and sync data](https://docs.creator.gg/guides/data-ingestion.md). It distinguishes field definitions from values, stable external IDs from changed emails, native webhook/API routes from Creator MCP, and actual writes from handoffs.
- [Email subscription preferences](https://docs.creator.gg/guides/email-preferences.md)
