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

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:

[
  {
    "email_settings": [
      { "email_address": "[email protected]", "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": true,
    "notify_on_weekly_campaign_performance_reports": false,
    "notify_on_call_activities": true,
    "can_login_via_platform": false
  }
]

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:

{
  "email_settings": [
    { "email_address": "[email protected]", "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": true,
  "notify_on_weekly_campaign_performance_reports": false,
  "notify_on_call_activities": true,
  "can_login_via_platform": false
}

Examples

Create an advertiser user

Endpoint:

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

Request Body:

{
  "user": {
    "id_from_network": "549494858585Dxlj2uCX0ijqXP4nAW",
    "email_settings": [
      { "email_address": "[email protected]", "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_performance_notifications": false,
    "notify_on_monthly_campaign_performance_reports": true,
    "notify_on_weekly_campaign_performance_reports": false,
    "notify_on_call_activities": true
  }
}

Examples

Update an Advertiser User

Endpoint:

https://invoca.net/api/2022-08-01/<network_id>/advertisers/e0Fv6YEk/users/<user_id>

Request Body:

{
  "user": {
    "email_settings": [
      { "email_address": "[email protected]", "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": true,
    "notify_on_weekly_campaign_performance_reports": false,
    "notify_on_call_activities": true
  }
}

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:

{
}