What is a User?

A user represents an actual person. Each user will have their own contact information and notification preferences.

Users are independent objects in PagerTree and are associated to Accounts via the Account User relationship. Please see account organization for full details on how this relationship works.


Roles are specific to the Account context. Please see roles section regarding permissions within an account.



Time Zone


The preferred time zone of the user. Affects how times are displayed in the UI.

Preferred Language


The preferred language of the user. Affects how the UI is translated. Supported languages are English, Spanish, French, German, and Dutch.

Notification Rules


The notification rules to use when getting notified about alerts for this account.

Going On-Call Notifications


Going On-Call notification settings. See going on-call docs below.

Going Off-Call Notifications


Going Off-Call notification settings. See going on-call docs below.

Emoji Mode


Display Emojis in the navbar.

Advanced Mode


Display "advanced" models. See advanced mode below.

Debug Mode


Display "debug" models. (usually only used for support).

App Notification Persistent


Persistent notification setting for the mobile application.

App Notification Sound


Notification sounds setting for the mobile application.

Advanced Mode

By default PagerTree hides many of the more "advanced" functionality. To view advanced objects you will need to enable advanced mode.

  1. Navigate to the My Settings Page.

  2. Scroll to the Other Settings section.

  3. Check the Advanced Mode checkbox.

  4. Click Update.

You should now see the advanced options in the navigation menu.


  • A user can have 1 or more emails.

  • An email address must be deliverable.

  • Email addresses that bounce, report a spam complaint, or are not deliverable will be blocked and receive no further notifications.

Phone Numbers

  • A user can have 1 or more phones.

  • A phone must be verified before PagerTree will begin sending notifications.

Phone Verification

  1. Navigate to the My Settings Page.

  2. Input your mobile phone number and choose a verification channel.

  3. Click Update.

  4. Click Verify.

  5. Input your verification code and click Update.

be redirectedIf successful, you will be redirected to the My Settings page with the message "Phone verified successfully".


Default Notification Channels

User's can elect from the following default notification channels:

  • Push (app notification)

  • Email

  • SMS (text message)

  • Voice (automated call)

  • Slack

Voice notifications only apply to the alert open message.

Notification Rules

Notification rules allow custom notification sequences to be built for the alert open message. Please see the notification rules documentation for full details.

Going On-Call Notifications

Users can elect to get going on-call reminder notifications a configurable amount of time before their on-call shift starts. Additionally, users can specify which layers they would like to be reminded about (leave blank for all).

API Tokens

Users can use API Tokens to access the PagerTree API. API Tokens are scoped to the account.

Create an API Token

  1. Scroll to the "API Tokens" section.

  2. Click the New API Token button.

  3. Provide a Name and click Create button.

  4. Copy your Token.

You can now use your API Token to access the PagerTree API. Check out the API docs for full documentation.


All of the following security options can be found from the My Settings Page.

Two Factor Authentication

PagerTree supports two factor authentication (2FA). To enable two factor authentication:

  1. Scroll to the "Two-factor Authentication" section.

  2. Click the Enable two-factor authentication button.

  3. Copy the recovery codes and store them somewhere secure.

  4. With your 2FA app, scan the bar code and enter the six digit code.

  5. If successful, you will be redirected the the My Settings page with a notice stating "Two-factor authentication was enabled successfully".

You will now be required to use 2FA when logging in.

Single Sign-On

If a user is part of an account that is using Single Sign-On (SSO), they will be required to sign in via SSO to access the account.

Only account users that have the admin role can bypass the SSO login for SSO enabled accounts.

For instructions on how to configure SSO for an account, please see SSO docs.

Reset Password

To reset your password you will need to know your current password. If you have forgotten your current password, please see forgot-password documentation.

  1. Scroll to the "Password Settings" section.

  2. On the "Password Settings" Form

    • Provide your current password

    • Provide a new password

    • Confirm your new password

  3. Click Update.

Forgot Password

If you have forgotten your password, you can reset it from the application forgot password page.

Last updated