Beeswax

Accounts, Users, Roles, Permissions

The diagram below shows the relationship between these key objects:

Accounts

Buzz supports multi-tenant SaaS usage through the establishment of Accounts that separate access for most objects. Outside of Users enabled as Super Users all actions within Buzz are restricted to the scope of the Account in which the requesting user exists.

Only Super Users or Multi-Account users can create or edit Accounts.

Users

Every action in Buzz is completed by a User. Users may be set as Super Users, for access across Accounts, but only a Super User can create or edit another Super User.

Roles

Every User must be assigned a Role, which determines the User’s rights to read, edit, write and delete Objects. A Role is defined by a series of Permissions, each of which corresponds to an Object.

Global Roles are created by the system administrator and are available to all Accounts. The only reason to create a Role other than the global ones is if you need different or more granular permissions for certain objects than what is provided by the Global Roles. In these cases, you can create your own Roles that inherit permissions from one of the Global Roles.

Permissions

Permissions are defined by the Object name and a 4-bit operator corresponding to read, create, update, and delete privileges, respectively.

Action

Read

Create

Update

Delete

Value

1

2

4

8

If a Permission is set to 1, the User enabled can only read that type of object. If set to 3, the User can Read and Create the object (1+2). When a Permission is set to 15 then have full rights to the object (1+2+4+8). Examples:

Object

Value

Description

advertiser

7

User can read, create, and update advertisers, but not delete them

campaign

15

User has full access to campaigns

line_item

3

User can read and create line_items, but cannot edit or delete them

segment

0

User cannot perform any action on segments

Updated less than a minute ago

Accounts, Users, Roles, Permissions


Suggested Edits are limited on API Reference Pages

You can only suggest edits to Markdown body content, but not to the API spec.