Introduction

A general overview of what Service Accounts are and why we use them.

Overview

All programmatic interaction with our REST API is done using a logged-in Service Account. Once the client has been authenticated, the program interacting with the API will be able to perform operations as an administrator of the organization.

Service Account vs User Account

There are two types of accounts available; the user and the service account. A user account represents a person, and requires an email and authentication that is suited for user authentication (password or SSO using SAML). A Service Account represents a program, and the authentication scheme is optimized for machine to machine authentication using key-secret pairs that can be rotated if needed.

The service account is bound to a single organization, while a user account can be bound to multiple organizations.