Creates a project affiliate row (managed affiliate) for the project resolved from the API key.
Returns the same enriched shape as GET /v1/project-affiliates/{projectAffiliateId} (tiers, protections, audiences, tax).
When to use
- Server-side or automation onboarding of affiliates without wallet signatures
- Bulk provisioning from CRM or internal tools
When NOT to use
- Self-serve affiliate code signup (use
POST /v1/affiliateswith signatures)
Tier approvals
approve_project_tier_ids may list any project tiers; only tiers that require manual project approval are approved.
If at least one listed tier requires manual approval, send reviewed_by_user_id (project member). Duplicate ids are de-duplicated.
When tier_protection targets a tier that requires manual approval, also send reviewed_by_user_id so the API can record the approval on create (same outcome as the dashboard save flow).
Tier protection
Optional tier_protection: provide exactly one of expires_at (ISO 8601) or protection_days (1–365), plus tier_id.
Rate limits
Standard project API key limits apply (100 requests/minute unless otherwise configured).
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||