edcc34aa6d
Create centralized tools/ directory with REGISTRY.md index and 29 integration guides covering analytics, SEO, CRM, payments, referral, email, ads, automation, and commerce platforms. Each guide includes API endpoints, authentication, common operations, and links to relevant skills. Updated AGENTS.md and key skills (referral-program, analytics-tracking, email-sequence, paid-ads) with tool integration references. Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
3.2 KiB
3.2 KiB
Rewardful
Affiliate and referral tracking for Stripe-based SaaS businesses.
Capabilities
| Integration | Available | Notes |
|---|---|---|
| API | ✓ | REST API for affiliates, referrals, commissions |
| MCP | - | Not available |
| CLI | - | Not available |
| SDK | - | API-only, JavaScript snippet for tracking |
Authentication
- Type: API Key
- Header:
Authorization: Bearer {api_secret} - Get key: Settings > API in Rewardful dashboard
Common Agent Operations
List affiliates
GET https://api.getrewardful.com/v1/affiliates
Get affiliate by ID
GET https://api.getrewardful.com/v1/affiliates/{affiliate_id}
Search affiliate by email
GET https://api.getrewardful.com/v1/affiliates?email=affiliate@example.com
Get referral by Stripe customer
GET https://api.getrewardful.com/v1/referrals?stripe_customer_id={customer_id}
List referrals for affiliate
GET https://api.getrewardful.com/v1/referrals?affiliate_id={affiliate_id}
Get commission details
GET https://api.getrewardful.com/v1/commissions/{commission_id}
List commissions
GET https://api.getrewardful.com/v1/commissions?affiliate_id={affiliate_id}
Create affiliate link
POST https://api.getrewardful.com/v1/affiliates/{affiliate_id}/links
{
"token": "custom-link-token",
"url": "https://example.com/pricing"
}
Update affiliate
PUT https://api.getrewardful.com/v1/affiliates/{affiliate_id}
{
"first_name": "John",
"last_name": "Doe",
"paypal_email": "john@example.com"
}
JavaScript Tracking
Install snippet
<script>
(function(w,r){w._rwq=r;w[r]=w[r]||function(){(w[r].q=w[r].q||[]).push(arguments)}})(window,'rewardful');
</script>
<script async src='https://r.wdfl.co/rw.js' data-rewardful='YOUR_API_KEY'></script>
Track conversion manually
rewardful('convert', { email: 'customer@example.com' });
Webhook Events
| Event | When |
|---|---|
affiliate.created |
New affiliate signs up |
affiliate.approved |
Affiliate approved |
referral.created |
New referral tracked |
referral.converted |
Referral becomes customer |
commission.created |
Commission generated |
commission.paid |
Commission paid out |
Key Objects
- Affiliate - Partner promoting your product
- Referral - Tracked visit/lead from affiliate
- Commission - Earned payment for affiliate
- Campaign - Program with specific terms
- Link - Tracking URL for affiliate
Integration with Stripe
Rewardful automatically:
- Tracks referral cookie when user visits via affiliate link
- Associates Stripe customer with referral on checkout
- Creates commissions when subscriptions are paid
- Handles recurring commissions for subscriptions
When to Use
- Setting up affiliate/referral programs for SaaS
- Tracking referral attribution from Stripe payments
- Managing affiliate relationships
- Processing affiliate payouts
- Analyzing referral program performance
Rate Limits
- 120 requests per minute
- Contact support for higher limits
Relevant Skills
- referral-program
- pricing-strategy