> ## Documentation Index
> Fetch the complete documentation index at: https://docs.invoca.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Advertiser Users

For convenience, the API provides an interface for performing operations on specific advertiser users. This is useful for situations where it is inconvenient to send an array of all existing advertiser users. Actions for this endpoint can only be taken on users with value of false for `<can_login_via_platform>` field, indicating that the user’s authentication is managed by the network (and has access to the Invoca platform using SSO).

Endpoint:

`https://invoca.net/api/2022-08-01/<network_id>/advertisers/<advertiser_id_from_network>/users/<user_id_from_network>.json`

> [accordion] Get all Advertiser Users for Advertiser
>
> #### Examples
>
> Read all advertiser users for advertiser e0Fv6YEk
>
> Endpoint:
>
> `https://invoca.net/api/2022-08-01/<network_id>/advertisers/e0Fv6YEk/users.json`
>
> Format: application/json
>
> Response Code: 200
>
> Response Body:
>
> ```json theme={null}
> [
>   {
>     "email_settings": [
>       { "email_address": "chris@nfltix.com", "use_for_notifications": true }
>     ],
>     "id_from_network": "549494858585Dxlj2uCX0ijqXP4nAW",
>     "first_name": "Chris",
>     "contact_country_code": "1",
>     "last_name": "Dean",
>     "role": "Manager",
>     "oauth_refresh_token": "556588585858585858585858858",
>     "contact_phone_number": "888-603-3760",
>     "notify_on_budgets": true,
>     "notify_on_campaign_applications": false,
>     "notify_on_campaign_expirations": false,
>     "notify_on_creative_duplication_requests": true,
>     "notify_on_network_announcements": true,
>     "notify_on_performance_notifications": false,
>     "notify_on_monthly_campaign_performance_reports": false,
>     "notify_on_weekly_campaign_performance_reports": false,
>     "notify_on_call_activities": true,
>     "can_login_via_platform": false
>   }
> ]
> ```

> [accordion] Get an Advertiser User
>
> #### Examples
>
> Read a specific advertiser user
>
> Endpoint:
>
> `https://invoca.net/api/2022-08-01/<network_id>/advertisers/e0Fv6YEk/users/549494858585Dxlj2uCX0ijqXP4nAW.json`
>
> Format: application/json
>
> Response Code: 200
>
> Response Body:
>
> ```json theme={null}
> {
>   "email_settings": [
>     { "email_address": "chris@nfltix.com", "use_for_notifications": true }
>   ],
>   "id_from_network": "549494858585Dxlj2uCX0ijqXP4nAW",
>   "first_name": "Chris",
>   "contact_country_code": "1",
>   "last_name": "Dean",
>   "role": "Manager",
>   "oauth_refresh_token": "556588585858585858585858858",
>   "contact_phone_number": "888-603-3760",
>   "notify_on_budgets": true,
>   "notify_on_campaign_applications": false,
>   "notify_on_campaign_expirations": false,
>   "notify_on_creative_duplication_requests": true,
>   "notify_on_network_announcements": true,
>   "notify_on_performance_notifications": false,
>   "notify_on_monthly_campaign_performance_reports": false,
>   "notify_on_weekly_campaign_performance_reports": false,
>   "notify_on_call_activities": true,
>   "can_login_via_platform": false
> }
> ```

> [accordion] Create an Advertiser User
>
> #### Examples
>
> Create an advertiser user
>
> Endpoint:
>
> `https://invoca.net/api/2022-08-01/<network_id>/advertisers/e0Fv6YEk/users.json`
>
> Request Body:
>
> ```json theme={null}
> {
>   "user": {
>     "id_from_network": "549494858585Dxlj2uCX0ijqXP4nAW",
>     "email_settings": [
>       { "email_address": "chris@nfltix.com", "use_for_notifications": true }
>     ],
>     "first_name": "Chris",
>     "last_name": "Dean",
>     "contact_phone_number": "805-555-5555",
>     "oauth_refresh_token": "556588585858585858585858858",
>     "role": "Manager",
>     "notify_on_budgets": true,
>     "notify_on_campaign_applications": false,
>     "notify_on_campaign_expirations": false,
>     "notify_on_creative_duplication_requests": true,
>     "notify_on_network_announcements": true,
>     "notify_on_call_activities": true
>   }
> }
> ```

> [accordion] Update an Advertiser User
>
> #### Examples
>
> Update an Advertiser User
>
> Endpoint:
>
> `https://invoca.net/api/2022-08-01/<network_id>/advertisers/e0Fv6YEk/users/<user_id>`
>
> Request Body:
>
> ```json theme={null}
> {
>   "user": {
>     "email_settings": [
>       { "email_address": "chris@nfltix.com", "use_for_notifications": true }
>     ],
>     "id_from_network": "549494858585Dxlj2uCX0ijqXP4nAW",
>     "first_name": "Chris",
>     "contact_country_code": "1",
>     "last_name": "Dean",
>     "role": "Manager",
>     "oauth_refresh_token": "556588585858585858585858858",
>     "contact_phone_number": "888-603-3760",
>     "notify_on_budgets": true,
>     "notify_on_campaign_applications": false,
>     "notify_on_campaign_expirations": false,
>     "notify_on_creative_duplication_requests": true,
>     "notify_on_network_announcements": true,
>     "notify_on_call_activities": true
>   }
> }
> ```

> [accordion] Delete an Advertiser User
>
> #### Examples
>
> Delete an advertiser user
>
> Endpoint:
>
> `https://invoca.net/api/2022-08-01/<network_id>/advertisers/e0Fv6YEk/users/549494858585Dxlj2uCX0ijqXP4nAW.json`
>
> Format: application/json
>
> Response Code: 200
>
> Response Body:
>
> ```json theme={null}
> {
> }
> ```


## Related topics

- [Network Integration](https://docs.invoca.com/en/latest/api_documentation/network_integration/index.md)
- [How to Offer Different Payout Amounts to Each Publisher in a Campaign](https://docs.invoca.com/s/article/different-payout-amounts-publisher.md)
- [Call Details Report: Column Glossary](https://docs.invoca.com/s/article/call-details-column-glossary.md)
- [SA360 Error: "User Does Not Have Permission to View Advertiser"](https://docs.invoca.com/s/article/sa360-error-user-no-permission-advertiser.md)
- [Advertisers](https://docs.invoca.com/en/latest/api_documentation/network_integration/advertisers/index.md)