Adding a User

User permissions will allow you to invite additional team members and partners to use the platform and gain insights into the parts of your business that affect them most. You can organize users based upon job function, experience level, marketing type and any other factors that differentiate their role in your business.

The permissions will provide limited access to specific reports and report views, as well as dashboards, connections, settings and more. The below guide will walk through the setting of individual User Permissions.

User Types

There are four different user types. This will determine capabilities of the user.

TypeDescriptionRestrictions
User InterfaceThis user type has access to login to the platform.
CustomerCustomer Account refers to a user that would require a login to the Customer Portal.

This is for external customers to manage their subscriptions within your organization's Customer Portal.

This user will not be able to login to the User Interface with this User Type.

Vrio API

This is the newest version API user. This user type will have access to the Vrio API.

An API Key will be generated when the user is created. The full API Key is shown once, at the top of the user's page right after you click Submit. Copy it then. After that, only the last 4 characters are shown. If the API Key is lost, create a new Vrio API user.

This user will not be able to login to the User Interface with this User Type.
Legacy APIThis user type should only be used if your account was setup prior to September 2023. This is a legacy version API user.This user will not be able to login to the User Interface with this User Type.
📘

All New API Users should be set up as a Vrio API user.


User Groups

User Groups are permission levels already defined that are assigned to individual Users. This is a way to ensure permissions are setup as expected then applied to Users as created.

User Groups can be added and permission levels adjusted.

Learn more about User Groups here.


Individual User

Adding a User

  1. Select Settings in the top navigation

  2. Navigate to the Permissions tab

    Settings > Permissions tab
  3. Select Users

  4. Hit Add New User

    1. Enter First/Last Name & email for the user. unique email is required per user
    2. Select the User Group
    3. Set the User Type
    4. Send Activation email?
      1. If Checked, an email will be sent with a temporary password for the user to finalize setup of a unique & secure password.
      2. If Unchecked, you will be prompted to create the users password. If User Password is created, it can be reset within the UI.
  5. Hit Submit

🚧

Give each user access to only what they need for their role.
Choose the most restrictive User Group that works for them, and add User Restrictions where you can.
This applies to Vrio API users too: an API Key can do anything its User Group allows, including creating other users.

Forcing a Logout or Password Change

User Interface users have two settings on the Details tab of their user page. These settings are not available for Vrio API or Legacy API users.

  • Force Logout ends all of the user's active sessions. It clears automatically the next time they log in.
  • Force Password Change requires the user to set a new password at their next login. It clears automatically once they do. It only applies to users who were created with Send Activation Email checked.

If a user's login may have been compromised, check both Force Logout and Force Password Change, then click Save.
These settings are only shown to users whose User Group has Full Access to Users.

If a Vrio API user's API Key may have been compromised, uncheck Active on that user and click Save to turn off the API Key. Then create a new Vrio API user to get a new API Key, and update your integration to use it.


User Restrictions

In addition to assigning a User to a User Group for expanded or limited access, additional restrictions can be applied to the individual User level.

Individual Users may also be restricted to:

  • Connections
  • Campaigns
  • Merchants
  • Tracking1 Variable
  • Offers
  • IPs - IPv4 and IPv6

On the User, under the Restrictions Tab, you can implement these additional restrictions.

Restrictions Tab on User page
🚧

If the restriction sections are left blank, that means there are no restrictions in those areas.


Test & Validate

As always, if setting up strategic user permissions be sure to test those permissions prior to handing out access. Confirm you are limiting that user as expected.

It is easiest to do so by creating a test user for yourself and logging in to confirm you are seeing what is expected.

Hot tip, adding a "+" after your main gmail domain name, will allow you to create a unique email address. For example, if my email is [email protected] you can use [email protected]


See it in Action


Did this page help you?