API keys allow you to authenticate with the Rhombus API so you can build custom integrations, automate workflows, and connect third-party tools to your Rhombus organization. This article walks you through creating a new API key in the Rhombus Console.
Prerequisites
- Access to the Rhombus Console
- Appropriate user permissions to manage integrations and developer resources (typically an Administrator role)
Steps to Create an API Key
Step 1: Navigate to the Settings page
From the Rhombus Console, open the Settings page (https://console.rhombus.com/settings/)
Step 2: Open Integration and Developer Resources
Within Settings, select Integrations and Developer Resources (https://console.rhombus.com/settings/integrations/)
Step 3: Select API Tokens
In the Integration and Developer Resources section, click API Tokens.
Step 4: Click Add API Key
Click the Add API Key button to begin creating a new key.
Step 5: Complete the API key form
Fill out the form with the following details:
- Enter a descriptive Name for the API key (e.g., "Access Control Integration" or "Reporting Automation")
- Select API Token as the type (Can use Cert instead if desired)
- Assign the appropriate Role to define the key's permission level
When finished, click Save (or Create) to generate the key.
Step 6: Store your API key securely
Once the key is generated, copy it and store it in a secure environment, such as a password manager or secrets vault.
⚠️ Important: Treat your API key like a password. Do not share it publicly, commit it to source code repositories, or send it over unsecured channels. Anyone with access to your API key can act on your organization's behalf according to the role assigned to the key.
Best Practices
- Use descriptive names so you can easily identify what each key is used for.
- Assign the least-privileged role required for the integration's purpose.
- Rotate keys periodically and delete any keys that are no longer in use.
- Never hard-code keys directly into scripts or applications — use environment variables or a secrets manager instead.
Contact Support and Sales
Have more questions? Contact Rhombus Support at +1 (877) 746-6797 option 2 or support@rhombus.com.
Interested in learning more? Contact Rhombus Sales at +1 (877) 746-6797 option 1 or sales@rhombus.com.
Comments
0 comments
Article is closed for comments.