---
title: "Update Advertiser User"
method: PUT
path: "/networks/advertisers/{advertiserId}/users/{userId}"
tags: ["Advertiser Users"]
---

# Update Advertiser User

`PUT /networks/advertisers/{advertiserId}/users/{userId}`

## Request

- Base URL: `https://api.eflow.team/v1`
- URL: `https://api.eflow.team/v1/networks/advertisers/{advertiserId}/users/{userId}`
- Auth: API key in header `X-Eflow-Api-Key`
- TypeScript: <https://skmtc.dev/everflow/apis/everflow-network-api-tracking-domains/docs/networks/advertisers/:advertiserId/users/:userId/put.ts> (a function with typed inputs; its response is checked against the schema)

## Path parameters

- `advertiserId` integer, required
- `userId` integer, required

## Request body

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

## 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.

## Other responses

- `404`: Advertiser user not found.

---

[API](https://skmtc.dev/everflow/apis/everflow-network-api-tracking-domains.md) - [All operations](https://skmtc.dev/everflow/apis/everflow-network-api-tracking-domains/llms.txt) - [OpenAPI document](https://skmtc.dev/everflow/apis/everflow-network-api-tracking-domains/revisions/39242cee0e32?raw)