--- title: "Create Affiliate" method: POST path: "/networks/affiliates" tags: ["Affiliates"] --- # Create Affiliate `POST /networks/affiliates` ## Query parameters - `notification` boolean ## Request body - object - `name` string, required — The name of the affiliate. - `account_status` 'active' | 'inactive', required — The affiliate's account status. - `network_employee_id` integer, required — The employee ID of the affiliate's account manager. - `internal_notes` string — Internal notes for network usage. - `default_currency_id` string, required — The affiliate's default currency. Can be found using the [metadata API](/api-reference/get-metacurrencies). - `enable_media_cost_tracking_links` boolean — Whether or not you want to allow the affiliate to pass and override cost in their tracking links. Defaults to `false`. - `referrer_id` integer — 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` integer — 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 — Street address line 1. - `address_2` string — Apartment / suite. - `city` string — City name. - `region_code` string — State or region code (e.g. "CA"). - `country_code` string — Two-letter country code (e.g. "US"). - `zip_postal_code` string — ZIP or postal code. - `labels` string[] — Used to associate labels to the affiliate. - `users` object[] — One or more user accounts to create for this affiliate. Uses the same fields as the Create Affiliate User endpoint. - `first_name` string, required — The affiliate user's first name. - `last_name` string, required — The affiliate user's last name. - `email` string, required — The affiliate user's email. Must be unique among all affiliate users. Is used to log in the platform. - `language_id` integer, required — The affiliate user's language ID. This is limited to the value `1` (English). - `timezone_id` integer, required — The affiliate user's timezone ID. Can be found using the [metadata API](/api-reference/get-metatimezones). - `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` integer — The ID of an instant messaging platform. Allows you to save their identifier for further reference. `0` = None, `1` = Skype, `2` = Yahoo Messenger, `3` = Telegram, `4` = WhatsApp, `5` = Other. - `instant_messaging_identifier` string — The affiliate user's instant messaging identifier, if `instant_messaging_id` was different than `0`. - `currency_id` string, required — The affiliate user's currency ID. Can be found using the [metadata API](/api-reference/get-metacurrencies). - `account_status` 'active' | 'inactive', required — The affiliate user's account status. Can be either `active` or `inactive`. - `initial_password` string — The affiliate user's login password. If left empty, the affiliate will be sent an email asking to set their password. If supplied, the password must have a length of at least 12 characters. - `billing` object, required — The affiliate's billing information. - `billing_frequency` 'weekly' | 'bimonthly' | 'monthly' | 'two_months' | 'quarterly' | 'manual' | 'other', required — The affiliate's invoicing frequency. - `payment_type` 'none' | 'pay' | 'paypal' | 'check' | 'wire' | 'direct_deposit' | 'tipalti' | 'paxum' | 'veem' | 'payoneer' | 'bitcoin' | 'webmoney' | 'capitalist' | 'transferwise' | 'gift_card' | 'masspay' | 'skrill', required — The affiliate's payment type. `pay` refers to Everflow Pay. - `tax_id` string — The affiliate's tax ID. - `is_invoice_creation_auto` boolean — Configures automatic invoice creation 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` integer — Configures how many days to wait for invoice generation after the specified billing period. Defaults to `0`. - `invoice_amount_threshold` number, 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` integer — Configures the number of days that will be used as the payment term on generated invoices. Defaults to `0`. - `details` object, required — The affiliate's billing frequency details. Required when `billing_frequency` is set to anything other than `manual` or `other`, or when `payment_type` is not `none` (an empty object is required). - `day_of_week` integer — Specifies the day of the week, starting on Sunday (0=Sunday .. 6=Saturday). Required when `billing_frequency` is set to `weekly`. - `day_of_month_one` integer — Specifies first day of the month. Required when `billing_frequency` is set to `bimonthly`. - `day_of_month_two` integer — Specifies second day of the month. Required when `billing_frequency` is set to `bimonthly`. - `day_of_month` integer — Specifies day of the month. Required when `billing_frequency` is set to `monthly`, `two_months` or `quarterly`. - `starting_month` integer — Specifies the month from which the cycle is set to begin. Required when `billing_frequency` is set to `two_months` or `quarterly`. - `billing` object, required — The affiliate's payment method details. When `payment_type` is set to `none`, an empty object (`{}`) should be applied. - `paxum_id` string — The affiliate's Paxum ID. Required when `payment_type` is `paxum`. - `paypal_reception_method` 'email' | 'phone' | 'paypal_account' — The reception method used with PayPal. Required when `payment_type` is `paypal`. - `reception_identifier` string — The affiliate's PayPal reception identifier. Required when `payment_type` is `paypal`. - `email` string — The affiliate's email. Required when `payment_type` is `payoneer` or `veem`. - `is_existing_payee` boolean — Whether to assign an existing payee ID. Required when `payment_type` is `tipalti`. - `idap` string — The payee's IDAP (Payee ID). Required when `payment_type` is `tipalti` and `is_existing_payee` is `true`. - `first_name` string — The affiliate's first name. Required when `payment_type` is `veem`. - `last_name` string — The affiliate's last name. Required when `payment_type` is `veem`. - `phone` string — The affiliate's phone number (international format). Required when `payment_type` is `veem`. - `country_iso` string — The affiliate's country ISO code. Required when `payment_type` is `veem`. - `bank_name` string — The affiliate's bank name. Required when `payment_type` is `wire` or `direct_deposit`. - `bank_address` string — The affiliate's bank address. Required when `payment_type` is `wire` or `direct_deposit`. - `account_name` string — The affiliate's bank account name. Required when `payment_type` is `wire` or `direct_deposit`. - `account_number` string — The affiliate's bank account number. Required when `payment_type` is `wire` or `direct_deposit`. - `routing_number` string — The affiliate's bank routing number. Required when `payment_type` is `wire` or `direct_deposit`. - `swift_code` string — The affiliate's SWIFT code. Required when `payment_type` is `wire` or `direct_deposit`. ## Response `200` Affiliate created successfully. - Affiliate — An affiliate (partner) account in the network. - `network_affiliate_id` integer — Unique affiliate ID. - `network_id` integer — Network ID. - `name` string — Affiliate name. - `account_status` 'active' | 'inactive' | 'pending' | 'suspended' — Current account status. - `network_employee_id` integer — Account manager employee ID. - `internal_notes` string — Internal notes about this affiliate (not visible to the affiliate). - `default_currency_id` string — Default currency code (e.g. USD). - `enable_media_cost_tracking_links` boolean — Whether media cost tracking links are enabled for this affiliate. - `is_contact_address_enabled` boolean — Whether the contact address is enabled. - `network_affiliate_tier_id` integer — The affiliate tier ID this affiliate belongs to. Only used in create/update requests. - `has_notifications` boolean — Whether notifications are enabled. - `network_traffic_source_id` integer — Associated traffic source ID. - `account_executive_id` integer — Account executive employee ID. - `adress_id` integer — Address record ID. Note the field name uses a single 'd' (`adress_id`) in the API response. - `address_id` integer — Address record ID (alias). - `referrer_id` integer — ID of the referring affiliate, if any. - `contact_address` object — Contact address. Only used in create/update requests. - `address_1` string — Street address line 1. - `address_2` string — Apartment / suite. - `city` string — City name. - `region_code` string — State or region code (e.g. "CA"). - `country_code` string — Two-letter country code (e.g. "US"). - `zip_postal_code` string — ZIP or postal code. - `labels` string[] — Labels to assign. Only used in create/update requests. Use the relationship object to read labels. - `time_created` integer — Unix timestamp when the affiliate was created. - `time_saved` integer — Unix timestamp when the affiliate was last updated. - `relationship` object — Related data (only present when requested via query parameter). - `labels` object — Labels associated with this affiliate. - `total` integer — Total number of labels. - `entries` string[] — List of label strings. - `account_manager` object — Account manager details. - `first_name` string — Account manager's first name. - `last_name` string — Account manager's last name. - `email` string — Account manager's email address. - `work_phone` string — Account manager's work phone number. - `cell_phone` string — Account manager's cell phone number. - `instant_messaging_id` integer — Account manager's instant messaging platform ID. - `instant_messaging_identifier` string — Account manager's instant messaging identifier. - `encoded_value` string — Encoded tracking value. - `ios_app_sources` object — iOS app sources associated with this affiliate. - `total` integer — Total number of iOS app sources. - `entries` object[] — List of iOS app source records. - `users` object — User accounts associated with this affiliate. - `total` integer — Total number of users. - `entries` object[] — List of user records. - `overrides` object — Per-affiliate visibility overrides for advertiser variables. Controls which of `adv1`–`adv10` and `sale_amount` are visible to this partner, on a per-variable basis. - `total` integer — Total number of override entries. - `entries` object[] — List of variable visibility overrides. - `is_visible` boolean — Whether this variable is visible to the partner. - `variable` 'adv1' | 'adv2' | 'adv3' | 'adv4' | 'adv5' | 'adv6' | 'adv7' | 'adv8' | 'adv9' | 'adv10' | 'sale_amount' — The advertiser variable being controlled. --- [API](https://skmtc.net/everflow/apis/everflow-network-api-tracking-domains.md) · [All operations](https://skmtc.net/everflow/apis/everflow-network-api-tracking-domains/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/everflow/everflow-network-api-tracking-domains/revisions/39242cee0e32/schema)