Affiliates

Operations for affiliates

Find All

GET /v1/networks/affiliates

Paging

This endpoint supports paging. Refer to our User Guide for usage.

Filters

This endpoint supports basic filtering. Refer to API filters page for usage.

Value Description
time_created Filter based on the creation time
time_saved Filter based on the last update time
account_status Filter based on the account status

Relationships

This endpoint supports the following additional relationships. Refer to our User Guide for usage.

This endpoint supports additional relationships. You can ask for them using the relationship query parameter. Multiple relationships can be supplied repeating the relationship query parameter.

Value Description
reporting Includes reporting information
billing Includes billing and invoicing information
affiliate_payment_balance Includes the affiliate payment balance from outstanding invoices
coupon_codes Includes a list of the affiliate’s coupon codes
users Includes the list of affiliate users
audits Includes the revision history of changes made to the affiliate
visibility Includes lists of visible, hidden and rejected offers
signup Includes the affiliate’s signup info
api Includes the affiliate’s API keys
traffic_source Includes the affiliate’s traffic sources
referral_link Includes the affiliate’s referral link
referrer Include the affiliate’s referrer, if any
referral Includes the affiliate’s referral info
supply_partner Includes the affiliate’s EverXchange settings

cURL
curl --request GET 'https://api.eflow.team/v1/networks/affiliates' \
--header 'X-Eflow-API-Key: <INSERT API KEY>'
Response
{
    "affiliates": [
        {
            "network_affiliate_id": 1,
            "network_id": 346,
            "name": "Google",
            "account_status": "active",
            "network_employee_id": 6,
            "internal_notes": "",
            "has_notifications": true,
            "network_traffic_source_id": 0,
            "account_executive_id": 0,
            "adress_id": 0,
            "default_currency_id": "USD",
            "is_contact_address_enabled": false,
            "enable_media_cost_tracking_links": true,
            "time_created": 1554517251,
            "time_saved": 1560453624,
            "relationship": {
                "labels": {
                    "total": 1,
                    "entries": [
                        "Direct"
                    ]
                },
                "account_manager": {
                    "first_name": "Bob",
                    "last_name": "Smith",
                    "email": "my.everflow@gmail.com",
                    "work_phone": "",
                    "cell_phone": "",
                    "instant_messaging_id": 1,
                    "instant_messaging_identifier": "peter_mobaff"
                },
                "encoded_value": "28KL6"
            },
            "referrer_id": 0
        }
    ],
    "paging": {
        "page": 1,
        "page_size": 50,
        "total_count": 1
    }
}

Find By ID

GET /v1/networks/affiliates/:affiliateId

Relationships

This endpoint supports the following additional relationships. Refer to our User Guide for usage.

This endpoint supports additional relationships. You can ask for them using the relationship query parameter. Multiple relationships can be supplied repeating the relationship query parameter.

Value Description
reporting Includes reporting informations
billing Includes billing and invoicing informations
affiliate_payment_balance Includes the affiliate payment balance from outstanding invoices
coupon_codes Includes a list of the affiliate’s coupon codes
users Includes the list of affiliate users
audits Includes the revision history of changes made to the affiliate
visibility Includes lists of visible, hidden and rejected offers
signup Includes the affiliate’s signup info
api Includes the affiliate’s API keys
traffic_source Includes the affiliate’s traffic sources
referral_link Includes the affiliate’s referral link
referrer Include the affiliate’s referer, if any
referral Includes the affiliate’s referral info
supply_partner Includes the affiliate’s EverXchange settings

Path Parameters

Parameter Description
affiliateId The ID of the affiliate you want to fetch

cURL
curl --request GET 'https://api.eflow.team/v1/networks/affiliates/1' \
--header 'X-Eflow-API-Key: <INSERT API KEY>'
Response
 {
    "network_affiliate_id": 1,
    "network_id": 346,
    "name": "Google",
    "account_status": "active",
    "network_employee_id": 6,
    "internal_notes": "",
    "has_notifications": true,
    "network_traffic_source_id": 0,
    "account_executive_id": 0,
    "adress_id": 0,
    "default_currency_id": "USD",
    "is_contact_address_enabled": false,
    "enable_media_cost_tracking_links": true,
    "time_created": 1554517251,
    "time_saved": 1560453624,
    "relationship": {
        "labels": {
            "total": 1,
            "entries": [
                "Direct"
            ]
        },
        "account_manager": {
            "first_name": "Bob",
            "last_name": "Smith",
            "email": "my.everflow@gmail.com",
            "work_phone": "",
            "cell_phone": "",
            "instant_messaging_id": 1,
            "instant_messaging_identifier": "peter_mobaff"
        },
        "encoded_value": "28KL6"
    },
    "referrer_id": 0
}

Find (Advanced)

POST /v1/networks/affiliatestable

Paging

This endpoint supports paging. Refer to our User Guide for usage.

This endpoint supports query filters.

search_terms object array
search_type string

The name of the field used for search. Only “name” is supported.

value string

The value to search.

filters object
account_status string

Filter affiliates based on a specific account status. Supported values are: “active”, “inactive”, “pending” and “suspended”.

account_manager_ids int array

Only include affiliates managed by the specified account managers.

network_account_executives_ids int array

Only include affiliates managed by the specified account executives.

billing_frequency string

Filter affiliates based on a specific billing frequency. Supported values are: “weekly”, “bimonthly”, “monthly”, “two_months”, “quarterly”, “manual” and “other”.

payment_type string

Filter affiliates based on a specific payment type. Supported values are: “none”, “paypal”, “check”, “wire”, “direct_deposit”, “tipalti”, “paxum”, “veem”, “payoneer”, “bitcoin”, “webmoney”, “capitalist”, “gift_card”, “masspay” and “skrill”.

labels string array

Only include affiliates matching the specified labels.

ran_traffic_in_last_hours int

Only include affiliates that ran traffic in the last amount of hours specified.

network_tracking_domain_ids int array

Only include affiliates running traffic on the specified tracking domains.

cURL
curl --request POST 'https://api.eflow.team/v1/networks/affiliatestable' \
--header 'X-Eflow-API-Key: <INSERT API KEY>' \
--header 'Content-Type: application/json' \
--data '<INSERT PAYLOAD>'
Response
{
    "affiliates": [
        {
            "network_affiliate_id": 1,
            "network_id": 63,
            "name": "Google",
            "account_status": "active",
            "account_manager_id": 9,
            "account_manager_name": "Bob Smith",
            "account_executive_id": 15,
            "account_executive_name": "John Doe",
            "today_revenue": "$7993.00",
            "user": null,
            "time_created": 1515810377,
            "time_saved": 1584729057,
            "labels": [
                "w9"
            ],
            "balance": 0,
            "last_login": 1567529624,
            "global_tracking_domain_url": ""
        }
    ],
    "paging": {
        "page": 1,
        "page_size": 50,
        "total_count": 1
    }
}

Create

POST /v1/networks/affiliates

name string

The name of the affiliate

account_status string

The affiliate’s account status. Can either be active or inactive.

network_employee_id int

The employee id of the affiliate’s account manager.

internal_notes int

Internal notes for network usage

default_currency_id string

The affiliate’s default currency. Can be found using the metadata API

enable_media_cost_tracking_links boolean

Whether or not you want to allow affiliate to pass and override cost in their tracking links. Defaults to false.

referrer_id int

The id of the affiliate that referred the new affiliate. Defaults to 0 (none).

is_contact_address_enabled boolean

Whether or not you want to include a contact address for this affiliate. Defaults to false.

network_affiliate_tier_id int

The ID of the Affiliate Tier.

contact_address object

The affiliate’s contact address information. Only required if “is_contact_address_enabled” is set to true.

address_1 string

The address first line

address_2 string

The address second line

city string

The city name

region_code string

The region code. Can be found using the metadata API.

country_code string

The country code. Can be found using the metadata API.

zip_postal_code string

The ZIP or Postal code.

users object array

A list of affiliate users to be created along with the affiliate entity.

first_name string

The affiliate user’s first name

last_name string

The affiliate user’s last name

email string

The affiliate user’s email. Must be unique among all affiliate users. Is used to log in the platform.

account_status string

The affiliate user’s account status. Can be either active or inactive.

title string

The affiliate user’s title.

work_phone string

The affiliate user’s work phone number.

cell_phone string

The affiliate user’s cell phone number.

instant_messaging_id int

The id of an instant messaging platform. Allows you to save their identifier for further reference.

instant_messaging_identifier string

The affiliate user’s instant messaging identifier, if instant_messaging_id was different than 0.

language_id int

The affiliate user’s language id. This is limited to the value 1 (English).

timezone_id int

The affiliate user’s timezone id. Can be found using the metadata API.

currency_id string

The affiliate user’s currency id. Can be found using the metadata API

initial_password string

The affiliate user’s login password. If left empty, the affiliate will be sent an email asking to set their password.

billing object

The affiliate’s billing information.

billing_frequency string

The affiliate’s invoicing frequency. Can be one of the following values: weekly, bimonthly, monthly, two_months, quarterly, manual or other.

payment_type string

The affiliate’s payment type. Can be one of the following values: none, paypal, check, wire, direct_deposit, tipalti, payum, veem, payoneer, bitcoin, webmoney, capitalist, gift_card, masspay or skrill

tax_id string

The affiliate’s tax id.

is_invoice_creation_auto boolean

Configures automatic invoice creations for the affiliate. Defaults to “false”.

auto_invoice_start_date string

Configures automatic invoice creation start date. Dates are formatted “YYYY-mm-dd”. Required if is_invoice_creation_auto is set to true.

default_invoice_is_hidden boolean

Configures whether invoices are hidden from the affiliate by default. Defaults to “false”.

invoice_generation_days_delay boolean

Configures how many days to wait for invoice generation after the specified billing period. Defaults to 0.

invoice_amount_threshold double

Configures the minimal amount required for an invoice to be generated. Sums below the threshold are rolled over to the next billing period. Defaults to 0.

default_payment_terms int

Configures the number of days that will be used as the payment term on generated invoices. Defaults to 0.

details object

The affiliate’s billing frequency details. Required when “billing_frequency” is set to anything else than “manual” or “other”.

day_of_week int

Specifies the day of the week, starting on. Required when “billing_frequency” is set to “weekly”.

day_of_month_one int

Specifies first the day of the month. Required when “billing_frequency” is set to “bimonthly”.

day_of_month_two int

Specifies second the day of the month. Required when “billing_frequency” is set to “bimonthly”.

day_of_month int

Specifies day of the month. Required when “billing_frequency” is set to “monthly”, “two_months” or “quarterly”.

starting_month int

Specifies the month from which the cycle is set to begin. Required when “billing_frequency” is set to “two_months” or “quarterly”.

billing object

The affiliate’s payment method details. Required when “payment_type” is set to anything else than “none”.

paxum_id string

The affiliate’s paxum id. Required when “payment_type” is set to “paxum”.

paypal_reception_method string

The reception method used with Paypal. Can be either “email”, “phone” or “paypal_account”. Required when “payment_type” is set to “paypal”.

reception_identifier string

The affiliate’s paypal reception identifier. Required when “payment_type” is set to “paypal”.

email string

The affiliate’s email. Required when “payment_type” is set to “payoneer” or “veem”.

is_existing_payee boolean

Whether you want to assign an existing payee id to this affiliate. Required when “payment_type” is set to “tipalti”.

idap string

The payee’s IDAP (Payee ID). Required when “payment_type” is set to “tipalti” and is_existing_payee is set to true.

first_name string

The affiliate’s first name. Required when “payment_type” is set to “veem”.

last_name string

The affiliate’s last name. Required when “payment_type” is set to “veem”.

phone string

The affiliate’s phone number, must be international format. Required when “payment_type” is set to “veem”.

country_iso string

The affiliate’s country ISO code. Required when “payment_type” is set to “veem”.

bank_name string

The affiliate’s bank name. Required when “payment_type” is set to “wire” or “direct_deposit”.

bank_address string

The affiliate’s bank address. Required when “payment_type” is set to “wire” or “direct_deposit”.

account_name string

The affiliate’s bank account name. Required when “payment_type” is set to “wire” or “direct_deposit”.

account_number string

The affiliate’s bank account number. Required when “payment_type” is set to “wire” or “direct_deposit”.

routing_number string

The affiliate’s bank routing number. Required when “payment_type” is set to “wire” or “direct_deposit”.

swift_code string

The affiliate’s swift code. Required when “payment_type” is set to “wire” or “direct_deposit”.

{   
    "name": "Test Affiliate",
    "account_status": "active",
    "network_employee_id": 1,
    "internal_nodes": "This is a test affiliate created using the API",
    "default_currency_id": "USD",
    "enable_media_cost_tracking_links": false,
    "referrer_id": 0,
    "is_contact_address_enabled": true,
    "contact_address": {
        "address_1": "105 Ocean Avenue",
        "address_2": "",
        "city": "Los Angeles",
        "region_code": "CA",
        "country_code": "US",
        "zip_postal_code": "GHGHGH"
    },
    "users": [
        {
            "first_name": "Bob",
            "last_name": "Smith",
            "email": "my.everflow@gmail.com",
            "account_status": "active",
            "initial_password": "J0hnD0e2020!"
        }
    ],
    "billing": {
        "billing_frequency": "monthly",
        "payment_type": "none",
        "tax_id": "XXXXX",
        "details": {
            "day_of_month": 1,
        }
    }
}

Update

PUT /v1/networks/affiliates/:affiliateId

You must specify all the fields, not only the ones you wish to update.
If you omit a field that is not marked as required, its default value will be used.

Path Parameters

Parameter Description
affiliateId The ID of the affiliate you want to update

name string

The name of the affiliate

account_status string

The affiliate’s account status. Can either be active or inactive.

network_employee_id int

The employee id of the affiliate’s account manager.

internal_notes int

Internal notes for network usage

default_currency_id string

The affiliate’s default currency. Can be found using the metadata API (insert link)

enable_media_cost_tracking_links boolean

Whether or not you want to allow affiliate to pass and override cost in their tracking links. Defaults to false.

referrer_id int

The id of the affiliate that referred the new affiliate. Defaults to 0 (none).

is_contact_address_enabled boolean

Whether or not you want to include a contact address for this affiliate. Defaults to false.

network_affiliate_tier_id int

The ID of the Affiliate Tier.

contact_address object

The affiliate’s contact address information. Only required if “is_contact_address_enabled” is set to true.

address_1 string

The address first line

address_2 string

The address second line

city string

The city name

region_code string

The region code. Can be found using the metadata API.

country_code string

The country code. Can be found using the metadata API.

zip_postal_code string

The ZIP or Postal code.

billing object

The affiliate’s billing information.

billing_frequency string

The affiliate’s invoicing frequency. Can be one of the following values: weekly, bimonthly, monthly, two_months, quarterly, manual or other.

payment_type string

The affiliate’s payment type. Can be one of the following values: none, paypal, check, wire, direct_deposit, tipalti, payum, veem, payoneer, bitcoin, webmoney, capitalist, gift_card, masspay or skrill

tax_id string

The affiliate’s tax id.

is_invoice_creation_auto boolean

Configures automatic invoice creations for the affiliate. Defaults to “false”.

auto_invoice_start_date string

Configures automatic invoice creation start date. Dates are formatted “YYYY-mm-dd”. Required if is_invoice_creation_auto is set to true.

default_invoice_is_hidden boolean

Configures whether invoices are hidden from the affiliate by default. Defaults to “false”.

invoice_generation_days_delay boolean

Configures how many days to wait for invoice generation after the specified billing period. Defaults to 0.

invoice_amount_threshold double

Configures the minimal amount required for an invoice to be generated. Sums below the threshold are rolled over to the next billing period. Defaults to 0, which is none.

default_payment_terms int

Configures the number of days that will be used as the payment term on generated invoices. Defaults to 0.

details object

The affiliate’s billing frequency details. Required when “billing_frequency” is set to anything else than “manual” or “other”.

day_of_week int

Specifies the day of the week, starting on. Required when “billing_frequency” is set to “weekly”.

day_of_month_one int

Specifies first the day of the month. Required when “billing_frequency” is set to “bimonthly”.

day_of_month_two int

Specifies second the day of the month. Required when “billing_frequency” is set to “bimonthly”.

day_of_month int

Specifies day of the month. Required when “billing_frequency” is set to “monthly”, “two_months” or “quarterly”.

starting_month int

Specifies the month from which the cycle is set to begin. Required when “billing_frequency” is set to “two_months” or “quarterly”.

billing object

The affiliate’s payment method details. Required when “payment_type” is set to anything else than “none”.

paxum_id string

The affiliate’s paxum id. Required when “payment_type” is set to “paxum”.

paypal_reception_method string

The reception method used with Paypal. Can be either “email”, “phone” or “paypal_account”. Required when “payment_type” is set to “paypal”.

reception_identifier string

The affiliate’s paypal reception identifier. Required when “payment_type” is set to “paypal”.

email string

The affiliate’s email. Required when “payment_type” is set to “payoneer” or “veem”.

is_existing_payee boolean

Whether you want to assign an existing payee id to this affiliate. Required when “payment_type” is set to “tipalti”.

idap string

The payee’s IDAP (Payee ID). Required when “payment_type” is set to “tipalti” and is_existing_payee is set to true.

first_name string

The affiliate’s first name. Required when “payment_type” is set to “veem”.

last_name string

The affiliate’s last name. Required when “payment_type” is set to “veem”.

phone string

The affiliate’s phone number, must be international format. Required when “payment_type” is set to “veem”.

country_iso string

The affiliate’s country ISO code. Required when “payment_type” is set to “veem”.

bank_name string

The affiliate’s bank name. Required when “payment_type” is set to “wire” or “direct_deposit”.

bank_address string

The affiliate’s bank address. Required when “payment_type” is set to “wire” or “direct_deposit”.

account_name string

The affiliate’s bank account name. Required when “payment_type” is set to “wire” or “direct_deposit”.

account_number string

The affiliate’s bank account number. Required when “payment_type” is set to “wire” or “direct_deposit”.

routing_number string

The affiliate’s bank routing number. Required when “payment_type” is set to “wire” or “direct_deposit”.

swift_code string

The affiliate’s swift code. Required when “payment_type” is set to “wire” or “direct_deposit”.

{   
    "name": "Test Affiliate",
    "account_status": "active",
    "network_employee_id": 1,
    "internal_nodes": "This is a test affiliate created using the API",
    "default_currency_id": "USD",
    "enable_media_cost_tracking_links": false,
    "referrer_id": 0,
    "is_contact_address_enabled": true,
    "contact_address": {
        "address_1": "105 Ocean Avenue",
        "address_2": "",
        "city": "Los Angeles",
        "region_code": "CA",
        "country_code": "US",
        "zip_postal_code": "GHGHGH"
    },
    "billing": {
        "billing_frequency": "monthly",
        "payment_type": "none",
        "tax_id": "XXXXX",
        "details": {
            "day_of_month": 1,
        }
    }
}