Processing Ajax...

View Message
Close Dialog

Forward Message
Close Dialog

Separate email addresses with commas or semicolons.

Title
Close Dialog

Message

Confirm
Close Dialog

Confirm
Close Dialog

The CheckCentral API provides an endpoint for programmatically adding users.
To add a new user through the API, you will require an API token for your organization with Read/Write access. Organization administrators can create tokens through the API portal on your dashboard.
"User API Tokens" will only return data available to the user based on their granted permissions and user groups. Regular "API Tokens" have the Access Level given upon creation.
The endpoint is located at
https://api.checkcentral.cc/createUser/?apiToken=APITOKEN
where the APITOKEN placeholder is replaced with your valid token.
The request must be made with the
Content-Type
header set to
application/json
. The body of the request should contain the properties below to configure the new user's settings. Any properties not passed will be set to their default value.
For example, to add a new user you could send the following json in the body of the request:

Code

{
  "name": "Person Somename",
  "email": "person@myorg.realdomain",
  "accessLevel": "User",
  "sendWelcomeEmail": true,
  "userGroups": [
    "userGroupID"
  ],
  "notifications": [
    { 
        "type": "failures",
        "services": [
            "sms",
            "push"
        ]
    }
  ]
}
The user data must include an
email
property as well as an
accessLevel
.
The complete list of possible properties for user creation are as follows:
Parameter Type/Allowed Values Default
email
The email address of the new user.
This parameter is required.
String
accessLevel
The access level to grant the new user.
This parameter is required.
One of:
  • disabled
  • custom
  • readonly
  • user
  • editor
  • manager
  • administrator
name
The name for the new user.
If the
name
parameter is not included, the user's name will be set to their email address.
String
sendWelcomeEmail
Pass the
sendWelcomeEmail
flag to have CheckCentral send an introductory email to the new user.
Boolean
false
userGroups
Pass an array of user group IDs to add the user to those user groups. User group IDs can be retrieved with the
getUserGroups
API endpoint.
An array containing user group IDs.
[]
notifications
Pass an array of json objects to configure which services CheckCentral should use to communicate with the user.
An array containing one or more NotificationConfig parameters and values.
[]
Parameter Type/Allowed Values Default
type
Pass the type of notification to configure.
This parameter required for NotificationConfig objects.
One of:
  • digest
  • failures
  • warnings
  • unmatched
services
The list of services that CheckCentral should use to alert the user about the configured type of notification. Any services not included in the array will be disabled for the notification type.
Any of:
  • email
  • sms
  • push
  • pushbullet
  • pushover
[]
CheckCentral Monitoring consolidates and simplifies backup, system, and software email updates into a clean, graphical dashboard, bringing peace of mind to IT administrators of SMBs, Enterprises, and MSPs.
To learn more about CheckCentral, visit: https://www.checkcentral.cc
Binary Fortress has spent 15 years in pursuit of one goal: create software to make life easier. Our software ranges from display management and system enhancement utilities to monitoring tools and digital signage. IT administrators, professional gamers, coffee-shop owners, and MSPs all rely on Binary Fortress to make their days better, and their lives easier.
Copyright © 2007-2022 Binary Fortress Software, all rights reserved.
The Binary Fortress logo is a trademark of Binary Fortress Software.
The CheckCentral logo is a trademark of Binary Fortress Software.
Binary Fortress Software
1000 Innovation Drive, Suite 500
Kanata, Ontario, Canada
K2K3E7
https://www.binaryfortress.com