rewardful_create_affiliate

Add an affiliate (or a customer referrer, by passing stripe_customer_id). Rewardful sends NO welcome email for API-created affiliates. Rewardful: POST /v1/affiliates.

destructive

Argument	Type	Description
email*	string	Email address.
state	string	Affiliate state. Disabled/suspicious affiliates stop tracking and earning and can't log in.
token	string	Link token, e.g. `jb007` for ?via=jb007. Letters, numbers and dashes only.
last_name*	string	Last name.
first_name*	string	First name.
wise_email	string	Wise address commissions should be paid to.
campaign_id	string	Campaign to put the affiliate in (default campaign if omitted on create).
paypal_email	string	PayPal address commissions should be paid to.
stripe_customer_id	string	Customer-referral programs only: the live-mode Stripe customer that receives account credits.
receive_new_commission_notifications	boolean	Email the affiliate when they earn a commission (default true).

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "first_name",
    "last_name",
    "email"
  ],
  "properties": {
    "email": {
      "type": "string",
      "minLength": 3,
      "description": "Email address."
    },
    "state": {
      "enum": [
        "active",
        "disabled",
        "suspicious"
      ],
      "type": "string",
      "description": "Affiliate state. Disabled/suspicious affiliates stop tracking and earning and can't log in."
    },
    "token": {
      "type": "string",
      "pattern": "^[A-Za-z0-9-]+$",
      "description": "Link token, e.g. `jb007` for ?via=jb007. Letters, numbers and dashes only."
    },
    "last_name": {
      "type": "string",
      "minLength": 1,
      "description": "Last name."
    },
    "first_name": {
      "type": "string",
      "minLength": 1,
      "description": "First name."
    },
    "wise_email": {
      "type": "string",
      "description": "Wise address commissions should be paid to."
    },
    "campaign_id": {
      "type": "string",
      "description": "Campaign to put the affiliate in (default campaign if omitted on create)."
    },
    "paypal_email": {
      "type": "string",
      "description": "PayPal address commissions should be paid to."
    },
    "stripe_customer_id": {
      "type": "string",
      "description": "Customer-referral programs only: the live-mode Stripe customer that receives account credits."
    },
    "receive_new_commission_notifications": {
      "type": "boolean",
      "description": "Email the affiliate when they earn a commission (default true)."
    }
  }
}

rewardful_create_affiliate_coupon

Assign a coupon / promotion code to an affiliate so sales using it are credited to them. The code must match one defined in Stripe, and the affiliate's campaign must have a campaign coupon set in the dashboard. Rewardful: POST /v1/affiliate_coupons.

destructive

Argument	Type	Description
token*	string	The exact coupon / promotion code as defined in Stripe, e.g. MYCODE.
affiliate_id*	string	The affiliate's id (UUID).

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "affiliate_id",
    "token"
  ],
  "properties": {
    "token": {
      "type": "string",
      "minLength": 1,
      "description": "The exact coupon / promotion code as defined in Stripe, e.g. MYCODE."
    },
    "affiliate_id": {
      "type": "string",
      "minLength": 1,
      "description": "The affiliate's id (UUID)."
    }
  }
}

rewardful_create_affiliate_link

Give an affiliate an additional tracking link. A token is generated if omitted. Growth/Enterprise plans only. Rewardful: POST /v1/affiliate_links.

destructive

Argument	Type	Description
token	string	Link token, e.g. `jb007` for ?via=jb007. Letters, numbers and dashes only.
affiliate_id*	string	The affiliate's id (UUID).

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "affiliate_id"
  ],
  "properties": {
    "token": {
      "type": "string",
      "pattern": "^[A-Za-z0-9-]+$",
      "description": "Link token, e.g. `jb007` for ?via=jb007. Letters, numbers and dashes only."
    },
    "affiliate_id": {
      "type": "string",
      "minLength": 1,
      "description": "The affiliate's id (UUID)."
    }
  }
}

rewardful_create_campaign

Create a new affiliate campaign with its reward rule. For reward_type percent pass commission_percent; for amount pass commission_amount_cents and commission_amount_currency. Rewardful: POST /v1/campaigns.

destructive

Argument	Type	Description
url*	string	Base URL used to build affiliate links, e.g. https://example.com.
name*	string	The campaign's name.
private	boolean	true = invite-only; false = anyone can sign up.
reward_type*	string	Percent of each sale, or a fixed amount.
stripe_coupon_id	string	Stripe coupon for double-sided incentives. Growth/Enterprise plans only.
commission_percent	number	Commission percentage. Required when reward_type is percent.
minimum_payout_cents	integer	Minimum cumulative commissions before a payout, in cents of the company's display currency.
commission_amount_cents

rewardful_get_affiliate

Fetch a single affiliate by id, including their campaign, links, coupon and visitor/lead/conversion counts. Rewardful: GET /v1/affiliates/:id.

read-only

Argument	Type	Description
affiliate_id*	string	The affiliate's id (UUID).

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "affiliate_id"
  ],
  "properties": {
    "affiliate_id": {
      "type": "string",
      "minLength": 1,
      "description": "The affiliate's id (UUID)."
    }
  }
}

rewardful_get_affiliate_coupon

Fetch a single affiliate coupon by id. Rewardful: GET /v1/affiliate_coupons/:id.

read-only

Argument	Type	Description
coupon_id*	string	The affiliate coupon's id (UUID).

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "coupon_id"
  ],
  "properties": {
    "coupon_id": {
      "type": "string",
      "minLength": 1,
      "description": "The affiliate coupon's id (UUID)."
    }
  }
}

rewardful_get_affiliate_link

Fetch a single affiliate link by id. Rewardful: GET /v1/affiliate_links/:id.

read-only

Argument	Type	Description
link_id*	string	The affiliate link's id (UUID).

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "link_id"
  ],
  "properties": {
    "link_id": {
      "type": "string",
      "minLength": 1,
      "description": "The affiliate link's id (UUID)."
    }
  }
}

rewardful_get_campaign

Fetch a single campaign by id. Rewardful: GET /v1/campaigns/:id.

read-only

Argument	Type	Description
campaign_id*	string	The campaign's id (UUID).

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "campaign_id"
  ],
  "properties": {
    "campaign_id": {
      "type": "string",
      "minLength": 1,
      "description": "The campaign's id (UUID)."
    }
  }
}

rewardful_get_commission

Fetch a single commission by id, with its campaign and the sale (charge, refund and tax amounts, referral, customer, affiliate) that earned it. Rewardful: GET /v1/commissions/:id.

read-only

Argument	Type	Description
commission_id*	string	The commission's id (UUID).

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "commission_id"
  ],
  "properties": {
    "commission_id": {
      "type": "string",
      "minLength": 1,
      "description": "The commission's id (UUID)."
    }
  }
}

rewardful_get_payout

Fetch a single payout by id, with the affiliate and the commissions it bundles. Rewardful: GET /v1/payouts/:id.

read-only

Argument	Type	Description
payout_id*	string	The payout's id (UUID).

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "payout_id"
  ],
  "properties": {
    "payout_id": {
      "type": "string",
      "minLength": 1,
      "description": "The payout's id (UUID)."
    }
  }
}

rewardful_list_affiliate_coupons

List affiliate coupon / promotion codes (token, Stripe id, leads, conversions, archived), optionally for one affiliate. Rewardful: GET /v1/affiliate_coupons.

read-only

Argument	Type	Description
page	integer	Page number, from 1. See pagination.next_page.
limit	integer	Results per page, 1-100 (default 25).
affiliate_id	string	Only this affiliate's coupons.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "page": {
      "type": "integer",
      "maximum": 9007199254740991,
      "minimum": 1,
      "description": "Page number, from 1. See pagination.next_page."
    },
    "limit": {
      "type": "integer",
      "maximum": 100,
      "minimum": 1,
      "description": "Results per page, 1-100 (default 25)."
    },
    "affiliate_id": {
      "type": "string",
      "description": "Only this affiliate's coupons."
    }
  }
}

rewardful_list_affiliate_links

List affiliate links (URL, token, visitors, leads, conversions, affiliate_id), newest first. Rewardful: GET /v1/affiliate_links.

read-only

Argument	Type	Description
page	integer	Page number, from 1. See pagination.next_page.
limit	integer	Results per page, 1-100 (default 25).

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "page": {
      "type": "integer",
      "maximum": 9007199254740991,
      "minimum": 1,
      "description": "Page number, from 1. See pagination.next_page."
    },
    "limit": {
      "type": "integer",
      "maximum": 100,
      "minimum": 1,
      "description": "Results per page, 1-100 (default 25)."
    }
  }
}

rewardful_list_affiliates

List affiliates, newest first, with visitors/leads/conversions. Filter by campaign, or look one up by email or Stripe customer id (returns zero or one). Expand campaign, links or commission_stats for more detail. Rewardful: GET /v1/affiliates.

read-only

Argument	Type	Description
page	integer	Page number, from 1. See pagination.next_page.
email	string	Only the affiliate with this email.
limit	integer	Results per page, 1-100 (default 25).
expand	array	Nested objects to include for each affiliate.
campaign_id	string	Only affiliates in this campaign.
stripe_customer_id	string	Only the customer-referrer affiliate tied to this Stripe customer (cus_...).

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "page": {
      "type": "integer",
      "maximum": 9007199254740991,
      "minimum": 1,
      "description": "Page number, from 1. See pagination.next_page."
    },
    "email": {
      "type": "string",
      "description": "Only the affiliate with this email."
    },
    "limit": {
      "type": "integer",
      "maximum": 100,
      "minimum": 1,
      "description": "Results per page, 1-100 (default 25)."
    },
    "expand": {
      "type": "array",
      "items": {
        "enum": [
          "campaign",
          "links",
          "commission_stats"
        ],
        "type": "string"
      },
      "description": "Nested objects to include for each affiliate."
    },
    "campaign_id": {
      "type": "string",
      "description": "Only affiliates in this campaign."
    },
    "stripe_customer_id": {
      "type": "string",
      "description": "Only the customer-referrer affiliate tied to this Stripe customer (cus_...)."
    }
  }
}

rewardful_list_campaigns

List the affiliate program's campaigns with their reward rules (percent or fixed commission, payout minimum, referral expiry) and totals (visitors, leads, conversions, affiliates). Rewardful: GET /v1/campaigns.

read-only

Argument	Type	Description
page	integer	Page number, from 1. See pagination.next_page.
limit	integer	Results per page, 1-100 (default 25).

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "page": {
      "type": "integer",
      "maximum": 9007199254740991,
      "minimum": 1,
      "description": "Page number, from 1. See pagination.next_page."
    },
    "limit": {
      "type": "integer",
      "maximum": 100,
      "minimum": 1,
      "description": "Results per page, 1-100 (default 25)."
    }
  }
}

rewardful_list_commissions

List commissions (rewards owed for referred customers' payments) newest first, with amount in cents, currency and state (pending, due, paid, voided). Filter by affiliate or state; expand the sale (with referral, customer and affiliate) or campaign. Rewardful: GET /v1/commissions.

read-only

Argument	Type	Description
page	integer	Page number, from 1. See pagination.next_page.
limit	integer	Results per page, 1-100 (default 25).
state	array	Only commissions in these states.
expand	array	Nested objects to include for each commission.
affiliate_id	string	Only this affiliate's commissions.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "page": {
      "type": "integer",
      "maximum": 9007199254740991,
      "minimum": 1,
      "description": "Page number, from 1. See pagination.next_page."
    },
    "limit": {
      "type": "integer",
      "maximum": 100,
      "minimum": 1,
      "description": "Results per page, 1-100 (default 25)."
    },
    "state": {
      "type": "array",
      "items": {
        "enum": [
          "pending",
          "due",
          "paid",
          "voided"
        ],
        "type": "string"
      },
      "description": "Only commissions in these states."
    },
    "expand": {
      "type": "array",
      "items": {
        "enum": [
          "sale",
          "campaign"
        ],
        "type": "string"
      },
      "description": "Nested objects to include for each commission."
    },
    "affiliate_id": {
      "type": "string",
      "description": "Only this affiliate's commissions."
    }
  }
}

rewardful_list_payouts

List payouts — bundles of an affiliate's payable commissions — newest first, with amount, currency and state (pending, due, processing, paid). Filter by affiliate or state; expand affiliate or commissions. Rewardful: GET /v1/payouts.

read-only

Argument	Type	Description
page	integer	Page number, from 1. See pagination.next_page.
limit	integer	Results per page, 1-100 (default 25).
state	array	Only payouts in these states.
expand	array	Nested objects to include for each payout.
affiliate_id	string	Only this affiliate's payouts.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "page": {
      "type": "integer",
      "maximum": 9007199254740991,
      "minimum": 1,
      "description": "Page number, from 1. See pagination.next_page."
    },
    "limit": {
      "type": "integer",
      "maximum": 100,
      "minimum": 1,
      "description": "Results per page, 1-100 (default 25)."
    },
    "state": {
      "type": "array",
      "items": {
        "enum": [
          "pending",
          "due",
          "processing",
          "paid"
        ],
        "type": "string"
      },
      "description": "Only payouts in these states."
    },
    "expand": {
      "type": "array",
      "items": {
        "enum": [
          "affiliate",
          "commissions"
        ],
        "type": "string"
      },
      "description": "Nested objects to include for each payout."
    },
    "affiliate_id": {
      "type": "string",
      "description": "Only this affiliate's payouts."
    }
  }
}

rewardful_list_referrals

List referrals — visitors who arrived via an affiliate link — newest first, with their conversion state (visitor, lead, conversion), customer and link. Filter by affiliate, state, email, Stripe customer or an updated-at window. Rewardful: GET /v1/referrals.

read-only

Argument	Type	Description
page	integer	Page number, from 1. See pagination.next_page.
email	string	Only referrals with this customer email.
limit	integer	Results per page, 1-100 (default 25).
expand	array	Include the full affiliate object for each referral.
affiliate_id	string	Only this affiliate's referrals.
updated_since	string	ISO 8601 timestamp: only referrals updated after it.
updated_until	string	ISO 8601 timestamp: only referrals updated before it.
conversion_state	array	Only referrals currently in these conversion states.

rewardful_update_affiliate

Change an affiliate's name, email, payout emails, notifications, campaign (moves them) or state. Setting state to disabled stops tracking and earning; set it back to active to undo. Rewardful: PUT /v1/affiliates/:id.

destructive

Argument	Type	Description
email	string	Email address.
state	string	Affiliate state. Disabled/suspicious affiliates stop tracking and earning and can't log in.
last_name	string	Last name.
first_name	string	First name.
wise_email	string	Wise address commissions should be paid to.
campaign_id	string	Campaign to put the affiliate in (default campaign if omitted on create).
affiliate_id*	string	The affiliate's id (UUID).
paypal_email	string	PayPal address commissions should be paid to.
stripe_customer_id

rewardful_update_affiliate_link

Change the token of an existing affiliate link. WARNING: the old token stops tracking immediately — links already shared with it break. Prefer rewardful_create_affiliate_link to add a second token. Rewardful: PUT /v1/affiliate_links/:id.

destructive

Argument	Type	Description
token*	string	Link token, e.g. `jb007` for ?via=jb007. Letters, numbers and dashes only.
link_id*	string	The affiliate link's id (UUID).

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "link_id",
    "token"
  ],
  "properties": {
    "token": {
      "type": "string",
      "pattern": "^[A-Za-z0-9-]+$",
      "description": "Link token, e.g. `jb007` for ?via=jb007. Letters, numbers and dashes only."
    },
    "link_id": {
      "type": "string",
      "minLength": 1,
      "description": "The affiliate link's id (UUID)."
    }
  }
}

rewardful_update_campaign

Change a campaign's name, URL, visibility, reward rule, payout minimum or coupon. Only the fields you pass change. Rewardful: PUT /v1/campaigns/:id.

destructive

Argument	Type	Description
url	string	Base URL used to build affiliate links, e.g. https://example.com.
name	string	The campaign's name.
private	boolean	true = invite-only; false = anyone can sign up.
campaign_id*	string	The campaign's id (UUID).
reward_type	string	Percent of each sale, or a fixed amount.
stripe_coupon_id	string	Stripe coupon for double-sided incentives. Growth/Enterprise plans only.
commission_percent	number	Commission percentage. Required when reward_type is percent.
minimum_payout_cents	integer	Minimum cumulative commissions before a payout, in cents of the company's display currency.

Rewardful MCP by usefulapi

Try it

rewardful_create_affiliate Destructive

Rewardful MCP by usefulapi

Try it

rewardful_create_affiliate Destructive

Tools (20)