Permission scopes

OAuth scopes let you specify exactly how your app needs to access an Officient account. As an app developer, you specify your desired scopes in the developer dashboard. When a user is responding to your OAuth request, the requested scopes will be displayed to them when they are asked to approve your request.

Types of Scopes

Officient uses scopes that refer to the object they grant access to, followed by the class of actions on that object they allow (e.g. calendar:write).

The list of objects includes calendar, wage, personal.info,.., along with many other objects in Officient.

There are currently only two classes of action:

read: Reading the full information about a single resource.
write: Modifying the resource in any way e.g. creating, editing, or deleting.

For example, to request access to the personal calendars of people within Officient, your app would request calendar:read.