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

# affiliates_create

Create a referral partner, optionally enrolling in a campaign. Existing exact emails are rejected before submission because the underlying create API can update an existing partner. Not an atomic create-only guarantee; enrollment may have native notification effects. 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
{
  "affiliateEmail": "partner@example.com",
  "affiliateFirstName": "Taylor",
  "requestId": "example-affiliates_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": {
    "affiliateEmail": {
      "type": "string",
      "maxLength": 320,
      "format": "email",
      "pattern": "^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$"
    },
    "affiliateFirstName": {
      "type": "string",
      "minLength": 1,
      "maxLength": 500
    },
    "affiliateLastName": {
      "type": "string",
      "minLength": 1,
      "maxLength": 500
    },
    "phoneNumber": {
      "type": "string",
      "maxLength": 50
    },
    "websiteUrl": {
      "type": "string",
      "maxLength": 2000,
      "format": "uri"
    },
    "companyName": {
      "type": "string",
      "minLength": 1,
      "maxLength": 500
    },
    "companyPhoneNumber": {
      "type": "string",
      "maxLength": 50
    },
    "country": {
      "type": "string",
      "pattern": "^[A-Z]{2}$"
    },
    "address": {
      "type": "string",
      "minLength": 1,
      "maxLength": 500
    },
    "avatar": {
      "type": "string",
      "maxLength": 2000,
      "format": "uri"
    },
    "facebookUrl": {
      "type": "string",
      "maxLength": 2000,
      "format": "uri"
    },
    "twitterUrl": {
      "type": "string",
      "maxLength": 2000,
      "format": "uri"
    },
    "youtubeUrl": {
      "type": "string",
      "maxLength": 2000,
      "format": "uri"
    },
    "linkedInUrl": {
      "type": "string",
      "maxLength": 2000,
      "format": "uri"
    },
    "instagramUrl": {
      "type": "string",
      "maxLength": 2000,
      "format": "uri"
    },
    "campaignId": {
      "type": "string",
      "minLength": 1,
      "maxLength": 300,
      "pattern": "^[A-Za-z0-9_-]+$"
    },
    "parentAffiliateId": {
      "type": "string",
      "minLength": 1,
      "maxLength": 300,
      "pattern": "^[A-Za-z0-9_-]+$"
    },
    "tier": {
      "type": "integer",
      "minimum": 1,
      "maximum": 7
    },
    "requestId": {
      "type": "string",
      "pattern": "^[A-Za-z0-9_.:-]{8,128}$"
    }
  },
  "required": [
    "affiliateEmail",
    "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)
