---
title: "Create Advertiser User"
method: POST
path: "/networks/advertisers/{advertiserId}/users"
tags: ["Advertiser Users"]
---

# Create Advertiser User

`POST /networks/advertisers/{advertiserId}/users`

## Path parameters

- `advertiserId` integer, required

## Query parameters

- `notification` boolean

## Request body

- AdvertiserUserInput
  - `first_name` string, required — The advertiser user's first name.
  - `last_name` string, required — The advertiser user's last name.
  - `email` string, required — The advertiser user's email. Must be unique among all advertiser users. Used to log in the platform.
  - `title` string — The advertiser user's title.
  - `work_phone` string — The advertiser user's work phone number.
  - `cell_phone` string — The advertiser user's cell phone number.
  - `instant_messaging_id` integer — The ID of an instant messaging platform. Values are 0 for None, 1 for Skype, 2 for Yahoo Messenger, 3 for Telegram, 4 for WhatsApp, 5 for Other.
  - `instant_messaging_identifier` string — The advertiser user's instant messaging identifier. Required when an `instant_messaging_id` is selected.
  - `language_id` integer, required — The advertiser user's language ID. This is limited to the value 1 (English).
  - `timezone_id` integer, required — The advertiser user's timezone ID. Can be found using the metadata API.
  - `currency_id` string, required — The advertiser user's currency ID. Can be found using the metadata API.
  - `account_status` 'active' | 'inactive' | 'suspended', required — The advertiser user's account status.
  - `send_activation_email` boolean — When set to true, an activation email is sent to the user notifying them of their account creation.
  - `set_password_manually` boolean — When set to true, the `initial_password` field is required and will be used as the user's login password. When false, the user will receive a password reset email to set their own password.
  - `initial_password` string — The user's login password. Required when `set_password_manually` is true. Must be a minimum of 12 characters.

## Response `200`

- AdvertiserUser
  - `network_advertiser_user_id` integer — Unique advertiser user ID.
  - `network_id` integer — The network ID this user belongs to.
  - `network_advertiser_id` integer — The advertiser ID this user belongs to.
  - `first_name` string — The advertiser user's first name.
  - `last_name` string — The advertiser user's last name.
  - `email` string — The advertiser user's email address.
  - `title` string — The advertiser user's title.
  - `account_status` 'active' | 'inactive' | 'suspended' — The advertiser user's account status.
  - `work_phone` string — The advertiser user's work phone number.
  - `cell_phone` string — The advertiser user's cell phone number.
  - `instant_messaging_id` integer — The ID of an instant messaging platform. Values are 0 for None, 1 for Skype, 2 for Yahoo Messenger, 3 for Telegram, 4 for WhatsApp, 5 for Other.
  - `instant_messaging_identifier` string — The advertiser user's instant messaging identifier.
  - `language_id` integer — The advertiser user's language ID.
  - `timezone_id` integer — The advertiser user's timezone ID.
  - `currency_id` string — The advertiser user's currency ID (ISO currency code).
  - `relationship` object, nullable — Related data for this advertiser user. Populate by passing `relationship` query parameters (e.g. `?relationship=logins&relationship=api`).
    - `logins` object — The user's list of logins.
      - `total` integer — Total number of login records.
      - `entries` object[] — List of login records.
    - `password_history` object — The user's password changes history.
      - `total` integer — Total number of password change records.
      - `entries` object[] — List of password change records.
    - `customization` object — The user's customizations.
      - `network_advertiser_user_id` integer — The advertiser user ID this customization belongs to.
      - `dashboard_refresh_rate` integer — Dashboard refresh rate in seconds.
      - `pins_customization` string — JSON string of pinned dashboard widgets.
      - `columns_customization` string — JSON string of column display preferences.
      - `time_created` integer — Unix timestamp of creation.
      - `time_saved` integer — Unix timestamp of last update.
    - `api` object — API key and whitelisted IPs for this user.
      - `api_key` string — The user's API key. Empty if not generated.
      - `restricted_ips` string[], nullable — List of whitelisted IP addresses. Null if unrestricted.
  - `time_created` integer — Unix timestamp of creation.
  - `time_saved` integer — Unix timestamp of last update.

---

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