Need Help?

User and Account Management

Last Updated: Jan 22, 2016

Compass Account & User Management


This article describes a few typical account and user management tasks. For full documentation, please use the Compass API reference guide


To access the API, please go to and login. Please note that Account and User management calls can only be executed by a site admin.



Use case

Use of API

Create an Account

To create a new account use the POST /accounts/ endpoint and specify the name of the Account.


Once the Account is created, save the account id (“id”) to Notepad, especially if you are about to add users to the Account.


Create a User

To create a new user, use the POST /users/ endpoint and specify email, name, Default Account Id and whether the user is Admin.


Note: the email is the user id, and cannot be longer than 30 characters


The temporary password is returned by the call and should be saved so it can be shared with the user


If you forget to copy-and-paste the temporary password, you can reset it by using the POST /users/<email>/password/reset/ call.

Grant Permissions to a User

Before a user can use Compass, permissions must be granted.


To create a permission use use the POST /permissions/ endpoint and specify user’s email (id), account id and level (read, readwrite, manage)



Note: Permissions are granted to a user on a particular account, and if the users has access to multiple accounts, s/he can have different privileges.


Note: By default you should not give users admin access, as site admins have full access.


More Support

  • Please log in to see help articles and/or submit a support ticket
seconds ago
a minute ago
minutes ago
an hour ago
hours ago
a day ago
days ago
Invalid characters found