Skip to main content
POST
Create Affiliate Tier
Create a new affiliate tier. Tiers allow you to group affiliates and apply different payout margins based on performance or relationship level.

Authorizations

X-Eflow-Api-Key
string
header
required

The Everflow API key generated from the Control Center > Security.

Body

application/json
name
string
required

The name of the affiliate tier.

status
enum<string>
required

Status of the affiliate tier. Can be one of the following values - active, paused or deleted.

Available options:
active,
paused,
deleted
payout_margin
number
required

The payout margin percentage applied to affiliates in this tier.

is_default_tier
boolean
required

Whether or not the affiliate tier will be automatically tied to all new partners.

description
string

Optional description of the affiliate tier.

network_affiliate_ids
integer[] | null

IDs of the affiliates to assign to this tier.

labels
string[]

List of labels to associate with the affiliate tier.

Response

200 - application/json
network_affiliate_tier_id
integer

The unique ID of the affiliate tier.

network_id
integer

The ID of the network this tier belongs to.

name
string

The name of the affiliate tier.

status
enum<string>

Status of the affiliate tier. Can be one of the following values - active, paused or deleted.

Available options:
active,
paused,
deleted
description
string

Optional description of the affiliate tier.

network_affiliate_ids
integer[] | null

IDs of the affiliates assigned to this tier.

payout_margin
number

The affiliate's payout margin.

is_default_tier
boolean

Whether or not the affiliate tier will be automatically tied to all new partners.

time_created
integer

Unix timestamp of creation.

Example:

1734455015

time_saved
integer

Unix timestamp of last update.

Example:

1734455015

relationship
object

Related data for this affiliate tier. Populate by passing the relationship query parameter (e.g. ?relationship=all).