Sign in
Affiliates

Create affiliate

Creates or finds an affiliate for a company and user.

Required permissions:

  • affiliate:create
post/affiliates

Request body

account_idstring required

The ID of the company to create the affiliate for.

user_identifierstring required

The user identifier (username, email, user ID, or Discord ID).

Example request

{
  "account_id": "biz_xxxxxxxxxxxxxx"
}

Response

A successful response

active_members_countinteger required

The total active members of the affiliate

created_atstring date-time required

The datetime the affiliate was created.

customer_retention_ratestring required

The percentage of referred customers who are still active members

customer_retention_rate_ninety_daysstring required

The percentage of referred customers who remained active over the last 90 days

idstring required

The unique identifier for the affiliate.

monthly_recurring_revenue_usdstring required

The monthly recurring revenue generated by this affiliate's referrals, formatted as a USD currency string

status'active' | 'archived' | 'deleted' required

Statuses for resources

total_overrides_countinteger required

The total count of all overrides for this affiliate

total_referral_earnings_usdstring required

The total commission earnings paid to this affiliate, formatted as a USD currency string

total_referrals_countinteger required

The total referrals of the affiliate

total_revenue_usdstring required

The total revenue generated from this affiliate's referrals, formatted as a USD currency string

updated_atstring date-time required

The datetime the affiliate was last updated.

Example response

{
  "active_members_count": 42,
  "company": {
    "id": "biz_xxxxxxxxxxxxxx"
  },
  "created_at": "2023-12-01T05:00:00.401Z",
  "id": "aff_xxxxxxxxxxxxxx",
  "total_overrides_count": 42,
  "total_referrals_count": 42,
  "updated_at": "2023-12-01T05:00:00.401Z",
  "user": {
    "id": "user_xxxxxxxxxxxxx",
    "name": "Jane Smith",
    "username": "janesmith"
  }
}

Changes

Changed in 1 of the 74 revisions of this API.11

  • 697924df40d111See the full diff
    • ▲

      added the new required request property

      new-required-request-property

    • ●

      removed the request property

      request-property-removed

    This revision also has 9 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

Of the 74 revisions, 1 has no diff computed.