Learn how to create and manage service accounts for API and system integrations
The Service Accounts page, accessible from the left-hand sidebar, lists all existing service accounts in rows, with each row displaying key information about the respective account. Selecting a service account opens a dedicated view for it, providing access to two sections: Details and Permissions.
This section allows you configure granular Read and Write permissions per resource so the service account has only the access it needs for its integration.Use the Permissions section to:
View and edit Read or Write access for each permission group
Scope access so integrations can only read or write the resources you allow
You can create a service account directly from the Service Accounts page using the +Add Service button. Follow the steps outlined below to create a new service account.
You can manage a service account’s details and permissions once it has been created.
1
Open the Service Accounts page
Once inside Launchpad, navigate to the Service Accounts page located on the left-hand sidebar.
2
Click +Add Service
Once on Service Accounts, click the +Add Service button to create a new account.
3
Configure service account details
Complete the following fields for the new service account. The dialog provides fields for name, credential type, description, and site assignment.
The Add New Service Account dialog collects name, credential type, description, and site assignment
Hide Example Configuration
Field
Example Configuration
Name
BMS Integration
Credential Type
Private Key (JWT) or Client Secret
Description
Describe the Service Account purpose
Assign Sites(s)
Select one or more buildings from your portfolio
4
Save
Once you have configured the required details, click Save to create the service account.
5
Generate credentials
After you create the service account, generate the credentials based on the credential type you selected.
Private Key (JWT)
Client Secret
Select Generate Private Key on the service account detail page. Launchpad generates a key pair and downloads the private key file to your machine.
The private key file downloads only once. Store it in a secure location immediately. If you lose the key, you must generate a new one and update your integration.
Select Generate Client Secret on the service account detail page. Launchpad displays the secret value on screen.
The client secret displays only once. Copy and store it in a secure location immediately. If you lose the secret, you must generate a new one and update your integration.
