Skip to content

Marketing skills for Claude Code and AI agents. CRO, copywriting, SEO, analytics, and growth engineering.

4.9 KB
Raw Blame

PartnerStack

Partner and affiliate program management platform for SaaS companies with deal tracking, rewards, and multi-tier partnerships.

Capabilities

Integration Available Notes
API ✓ Vendor API v2 for partnerships, deals, customers, transactions
MCP - Not available
CLI ✓ partnerstack.js
SDK - No official SDK; REST API with Basic Auth

Authentication

  • Type: Basic Auth (Vendor API)
  • Header: Authorization: Basic {base64(public_key:secret_key)}
  • Get credentials: Vendor dashboard > Settings > Integrations > PartnerStack API Keys
  • Note: Separate Test and Production API keys. Test transactions can only be added to customers created with Test keys.

Common Agent Operations

List partnerships

GET https://api.partnerstack.com/api/v2/partnerships?limit=25

Authorization: Basic {base64(public_key:secret_key)}

Create a partnership

POST https://api.partnerstack.com/api/v2/partnerships

{
  "email": "[email protected]",
  "group_key": "affiliates",
  "first_name": "Jane",
  "last_name": "Smith"
}

List customers

GET https://api.partnerstack.com/api/v2/customers?limit=25

Create a customer (attribute to partner)

POST https://api.partnerstack.com/api/v2/customers

{
  "email": "[email protected]",
  "partner_key": "prtnr_abc123",
  "name": "John Doe"
}

Record a transaction

POST https://api.partnerstack.com/api/v2/transactions

{
  "customer_key": "cust_abc123",
  "amount": 9900,
  "currency": "USD",
  "product_key": "pro_plan"
}

List deals

GET https://api.partnerstack.com/api/v2/deals?limit=25

Create a deal

POST https://api.partnerstack.com/api/v2/deals

{
  "partner_key": "prtnr_abc123",
  "name": "Enterprise Opportunity",
  "amount": 50000,
  "stage": "qualified"
}

Record an action (event-based rewards)

The CLI maps --customer-key to the customer target and --action-key to the action type. --value is the number of occurrences, defaulting to one.

POST https://api.partnerstack.com/api/v2/actions

{
  "target_key": "cust_abc123",
  "target_type": "customer",
  "type": "signup_completed",
  "value": 1
}

Create a reward

POST https://api.partnerstack.com/api/v2/rewards

{
  "partner_key": "prtnr_abc123",
  "amount": 5000,
  "description": "Bonus for Q1 performance"
}

List leads

GET https://api.partnerstack.com/api/v2/leads?limit=25

Create a lead

POST https://api.partnerstack.com/api/v2/leads

{
  "partner_key": "prtnr_abc123",
  "email": "[email protected]",
  "name": "Potential Customer",
  "company": "Acme Corp"
}

List partner groups

GET https://api.partnerstack.com/api/v2/groups

Manage webhooks

Both the destination URL and a nonempty event list are required when creating a webhook (--target and --events in the CLI).

POST https://api.partnerstack.com/api/v2/webhooks

{
  "target_url": "https://example.com/webhooks/partnerstack",
  "events": ["deal.created", "transaction.created", "customer.created"]
}

API Pattern

PartnerStack uses cursor-based pagination. List responses include has_more and item keys for starting_after / ending_before parameters.

All responses follow the format:

{
  "data": { ... },
  "message": "...",
  "status": "2xx"
}

Key Metrics

Partnership Metrics

  • partner_key - Unique partner identifier
  • group - Partner tier/group
  • status - active, pending, archived
  • created_at - Partnership start date

Transaction Metrics

  • amount - Transaction value in cents
  • currency - Currency code
  • product_key - Associated product
  • customer_key - Associated customer

Deal Metrics

  • amount - Deal value
  • stage - Deal pipeline stage
  • status - open, won, lost

Reward Metrics

  • amount - Reward amount in cents
  • status - pending, approved, paid

Parameters

Pagination Parameters

  • limit - Items per page (1-250, default: 10)
  • starting_after - Cursor for next page (item key)
  • ending_before - Cursor for previous page (item key)
  • order_by - Sort field, prefix with - for descending

Common Filters

  • include_archived - Include archived records
  • has_sub_id - Filter by sub ID presence

When to Use

  • Managing SaaS affiliate and referral programs
  • Tracking partner-driven revenue and attributions
  • Automating partner onboarding and rewards
  • Deal registration and pipeline tracking
  • Multi-tier partnership programs (affiliates, resellers, agencies)
  • Event-based reward triggers (signups, upgrades, etc.)

Rate Limits

  • Not explicitly documented
  • Use reasonable request rates; implement exponential backoff on 429 responses

Relevant Skills

  • referrals
  • affiliate-marketing
  • partner-enablement
  • saas-metrics
  • launch-sequence