---
title: "Create Affiliate User"
method: POST
path: "/networks/affiliates/{affiliateId}/users"
tags: ["Affiliate Users"]
---

# Create Affiliate User

`POST /networks/affiliates/{affiliateId}/users`

## Path parameters

- `affiliateId` integer, required

## Query parameters

- `notification` boolean

## Request body

- object
  - `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.

## Response `200`

- AffiliateUser
  - `network_affiliate_user_id` integer — Unique affiliate user ID.
  - `network_id` integer — The network ID this user belongs to.
  - `network_affiliate_id` integer — The affiliate ID this user belongs to.
  - `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 address. Is used to log in the platform.
  - `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.
  - `instant_messaging_identifier` string — The affiliate user's instant messaging identifier.
  - `language_id` integer — The affiliate user's language ID.
  - `timezone_id` integer — The affiliate user's timezone ID.
  - `currency_id` string — The affiliate user's currency ID.
  - `account_status` 'active' | 'inactive' — The affiliate user's account status. Can be either `active` or `inactive`.
  - `relationship` object, nullable — Related data for this affiliate user. Populate by passing `relationship` query parameters (e.g. `?relationship=logins&relationship=api`).
    - `logins` object — Login history for this user.
      - `total` integer — Total number of login records.
      - `entries` object[] — List of login records.
    - `customization` object — User customization settings.
    - `audits` object — Audit history for this user.
      - `total` integer — Total number of audit records.
      - `entries` object[] — List of audit records.
    - `api` object — API key and whitelisted IPs for this user.
      - `total` integer — Total number of API key records.
      - `entries` object[] — List of API key records.
    - `affiliate_account_status` string — The account status of the affiliate this user belongs to. Always included in the response, even without requesting the `affiliate_status` relationship.
  - `time_created` integer — Unix timestamp of when the user was created.
  - `time_saved` integer — Unix timestamp of when the user was last updated.

---

[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)