<!-- Generated from Cogny's tool registry. Canonical page: https://cogny.com/integrations/rewardful/tools -->

# Rewardful tools in Cogny

Cogny's Rewardful integration exposes 23 tools (14 read, 8 write, 1 destructive) to an AI agent over MCP. The same tools are available on every plan, from your own AI client or inside the Cogny app.

- **Read** (14): only reads data.
- **Write** (8): creates or changes something.
- **Destructive** (1): deletes, removes or replaces something.

Over MCP your own AI client asks before it runs a write. To take a tool away from your agent, block it in Settings → Integrations.

## Notes

Rewardful connects with the account's API Secret, found on Rewardful's Company Settings page. Rewardful has one secret per account and no read-only or scoped keys: the secret gives full access to the account, so the tools listed here are what limits Cogny. The secret is sent only to api.getrewardful.com. If you rotate it in Rewardful, update the connection in Cogny; a rejected secret marks the connection as needing a reconnect.

Every id is a UUID that comes from a list tool. Money is in cents with an ISO currency code, and timestamps are ISO 8601.

Lists return up to 100 rows a page (Rewardful's default is 25) with a `pagination` object: `next_page` is null on the last page and `total_count` gives the full size. `expand` nests related objects where Rewardful supports it: `campaign`, `links` and `commission_stats` on affiliates, `affiliate` on referrals, `commission` on sales, `sale` and `campaign` on commissions, `affiliate` and `commissions` on payouts.

Rewardful's API allows about 45 requests per 30 seconds and answers HTTP 429 above that. The connector reports the limit so the agent waits and retries.

Two writes only run with `confirm=true`. `update_affiliate_link` replaces a link's token, and the old token stops tracking visits at once wherever the affiliate has published it. `mark_payout_paid` records a payout and every commission in it as paid. It is bookkeeping: Rewardful records that you paid the affiliate, and the payment itself happens outside this integration.

An affiliate created with `create_affiliate` gets no welcome email from Rewardful. Extra affiliate links (`create_affiliate_link`) and campaign Stripe coupons need Rewardful's Growth or Enterprise plan. `create_affiliate_coupon` only works for an affiliate whose campaign already has a campaign coupon, which is set up in the Rewardful dashboard, and the code must match one defined in Stripe.

## Known gaps

- Not yet run against a live Rewardful account. Every endpoint, parameter and request body was checked against Rewardful's published REST API reference, but responses have only been tested against samples.
- No date-range filter on sales, commissions or payouts: Rewardful's API has none. Lists are newest first, so the agent pages back until it passes the period it needs. Referrals can be filtered by when they were last updated.
- Sales and referrals can be listed but not fetched one at a time: Rewardful's API has no single-record endpoint for them.
- Rewardful documents `page` and `limit` on the affiliate, referral and commission lists. The other lists accept the same two arguments here, but Rewardful's reference doesn't spell them out per endpoint.
- No delete tools. Rewardful's API can permanently delete a commission; that is left to the Rewardful dashboard.
- No affiliate magic link. Rewardful's API can return a one-time login URL for an affiliate's dashboard; Cogny doesn't expose it.
- No recording of sales or leads. Creating or editing a sale by hand and converting a referral to a lead belong to a custom payment integration and aren't offered.
- No un-paying a payout: Rewardful's API has no such call. A single commission can be marked unpaid again with `update_commission`.
- Campaign settings beyond name, URL, visibility, commission terms, minimum payout and Stripe coupon (cookie window, commission duration, dashboard texts) can be read but not changed: Rewardful's API doesn't accept them.
- An affiliate's link token can be set when the affiliate is created, and changed afterwards with `update_affiliate_link`, not with `update_affiliate`.
- Webhooks aren't used: Cogny reads on request and doesn't receive Rewardful events.

## All tools

| Tool | Kind | What it does |
|---|---|---|
| `list_campaigns` | Read | List your Rewardful campaigns with their commission terms and totals for visitors, leads, conversions and affiliates. |
| `get_campaign` | Read | Get one Rewardful campaign: its URL, reward type, commission, minimum payout and visitor, lead and conversion totals. |
| `create_campaign` | Write | Create a new campaign in your Rewardful account with its own URL and commission terms. |
| `update_campaign` | Write | Change a Rewardful campaign's name, URL, visibility, commission terms or minimum payout. |
| `list_affiliates` | Read | List your Rewardful affiliates, newest first, with their state and visitor, lead and conversion counts. |
| `get_affiliate` | Read | Get one Rewardful affiliate with their campaign, links, coupon, state and visitor, lead and conversion counts. |
| `create_affiliate` | Write | Add a new affiliate to your Rewardful account, in a campaign of your choice or the default one. |
| `update_affiliate` | Write | Change a Rewardful affiliate's details, state, payout address or campaign. |
| `list_affiliate_links` | Read | List the affiliate links in your Rewardful account, newest first, each with its URL, token and visitor, lead and conversion counts. |
| `get_affiliate_link` | Read | Get one Rewardful affiliate link: its full URL, token, owner and visitor, lead and conversion counts. |
| `create_affiliate_link` | Write | Create an additional tracking link for a Rewardful affiliate. |
| `update_affiliate_link` | Write | Change the token of a Rewardful affiliate link. |
| `list_affiliate_coupons` | Read | List the coupon and promotion codes assigned to your Rewardful affiliates, with the leads and conversions each code brought in. |
| `get_affiliate_coupon` | Read | Get one Rewardful affiliate coupon: its code, the affiliate it belongs to, whether it is archived, and its leads and conversions. |
| `create_affiliate_coupon` | Write | Assign a coupon or promotion code to a Rewardful affiliate so sales made with that code are credited to them. |
| `list_referrals` | Read | List the visitors your Rewardful affiliates referred, newest first, and whether each is still a visitor, a lead or a paying customer. |
| `list_sales` | Read | List the purchases made by referred customers in Rewardful, with charged, refunded and tax amounts and the referral behind each sale. |
| `list_commissions` | Read | List the commissions your Rewardful affiliates have earned, newest first, with amount, currency and whether each is pending, due, paid or voided. |
| `get_commission` | Read | Get one Rewardful commission: its amount, state, due and paid dates, and the campaign and sale it came from. |
| `update_commission` | Write | Change when a Rewardful commission is due, or record it as paid or unpaid. |
| `list_payouts` | Read | List your Rewardful payouts, newest first: what each affiliate is owed or has been paid, and whether the payout is pending, due, processing or paid. |
| `get_payout` | Read | Get one Rewardful payout with its amount, state, the affiliate it is owed to and the commissions it bundles. |
| `mark_payout_paid` | Destructive | Record a Rewardful payout, and every commission in it, as paid. |

Exact input schemas come from `tools/list` once Rewardful is connected; the free plan is enough to check.

Missing something? Your agent can ask for it with `request_feature`.

---

All integrations: https://cogny.com/integrations/tools/index.md
Plans, approvals, limits and data protection: https://cogny.com/buying-guide.md
What Cogny is: https://cogny.com/llms.txt
