Advertiser Users

Operations for advertiser users

Find All

GET /v1/networks/advertisers/:advertiserId/users

Path Parameters

Parameter Description
advertiserId The ID of the advertiser whose users you want to fetch

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
logins Includes the user’s list of logins
password_history Includes the user’s password changes history
api Includes the user’s API key and whitelisted IPs
customizations Includes the user’s customizations

cURL
curl --request GET 'https://api.eflow.team/v1/networks/advertisers/1/users' \
--header 'X-Eflow-API-Key: <INSERT API KEY>'
Response
{
    "users": [
        {
            "network_advertiser_user_id": 17,
            "network_id": 1,
            "network_advertiser_id": 1,
            "first_name": "Bob",
            "last_name": "Smith",
            "email": "my.everflow@gmail.com",
            "title": "",
            "work_phone": "9655433513",
            "cell_phone": "",
            "instant_messaging_id": 0,
            "instant_messaging_identifier": "",
            "language_id": 1,
            "timezone_id": 75,
            "currency_id": "USD",
            "account_status": "active"
        }
    ]
}

Find By ID

GET /v1/networks/advertisers/:advertiserId/users/:userId

Path Parameters

Parameter Description
advertiserId The ID of the advertiser whose user you want to fetch
userId The ID of the user you want to fetch

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
logins Includes the user’s list of logins
password_history Includes the user’s password changes history
api Includes the user’s API key and whitelisted IPs
customizations Includes the user’s customizations

cURL
curl --request GET 'https://api.eflow.team/v1/networks/advertisers/1/users/17' \
--header 'X-Eflow-API-Key: <INSERT API KEY>'
Response
{
    "network_advertiser_user_id": 17,
    "network_id": 1,
    "network_advertiser_id": 13,
    "first_name": "Bob",
    "last_name": "Smitch",
    "email": "my.everflow@gmail.com",
    "title": "",
    "work_phone": "9655433513",
    "cell_phone": "",
    "instant_messaging_id": 0,
    "instant_messaging_identifier": "",
    "language_id": 1,
    "timezone_id": 75,
    "currency_id": "USD",
    "account_status": "active"
}

Create

POST /v1/networks/advertisers/:advertiserId/users

Path Parameters

Parameter Description
advertiserId The ID of the advertiser for whom to create a user

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

The ID of an instant messaging platform. Allows you to save their identifier for further reference. Values are 0 for None, 1 for Skype, 2 for Yahoo Messenger.

instant_messaging_identifier string

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

language_id int

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

timezone_id int

The advertiser user’s timezone ID. Can be found using the metadata API.

currency_id string

The advertiser user’s currency ID. Can be found using the metadata API.

account_status string

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

initial_password string

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

{
    "currency_id": "USD",
    "instant_messaging_id": 0,
    "account_status": "active",
    "language_id": 1,
    "timezone_id": 90,
    "initial_password": "",
    "first_name": "Bob",
    "last_name": "Smith",
    "title": "Manager",
    "work_phone": "1234567788",
    "email": "my.everflow@gmail.com"
}

Update

PUT /v1/networks/advertisers/:advertiserId/users/:userId

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
advertiserId The ID of the advertiser whose user you want to update
userId The ID of the user you want to update

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. Must be unique among all advertiser users. Is 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 int

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

instant_messaging_identifier string

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

language_id int

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

timezone_id int

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

currency_id string

The advertiser user’s currency id. Can be found using the metadata API (insert link)

account_status string

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

initial_password string

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

{
    "currency_id": "USD",
    "instant_messaging_id": 0,
    "account_status": "active",
    "language_id": 1,
    "timezone_id": 90,
    "initial_password": "",
    "first_name": "Bob",
    "last_name": "Smith",
    "title": "Manager",
    "work_phone": "1234567788",
    "email": "my.everflow@gmail.com"
}