Create project affiliate (managed)

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/affiliates with 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).

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Body Params
string
required

Affiliate user identifier (e.g. EVM address, normalized by the API for EVM).

string
enum
required

The type of identifier being used for identifying the user.

Allowed:
string
string

Affiliate region code (e.g. EU, Other).

string
enum
Allowed:
string
audiences
array of uuids

Audience ids to assign to this affiliate in the project.

audiences
approve_project_tier_ids
array of uuids

Optional list of project tier ids. Only tiers with manual project approval are approved; other ids are ignored.
If the list contains at least one such tier, requires reviewed_by_user_id (project member) stored on approval rows.

approve_project_tier_ids
uuid

Required when tier_protection uses a tier that requires manual approval, or when approve_project_tier_ids
includes any tier that requires manual approval. Must be a user with membership in the project.

tier_protection
object
Responses

Language
Credentials
Bearer
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json