API Keys
API keys are used to authenticate requests to the Manage.Management API.Generating an API Key
1
Navigate to Settings
Go to your building dashboard and click Settings
2
Open API Settings
Select the API tab
3
Generate Key
Click Generate API Key and give it a descriptive name
4
Copy Key
Copy the key immediately - it won’t be shown again
Using Your API Key
Include your API key in theAuthorization header:
Key Types
| Type | Prefix | Use Case |
|---|---|---|
| Live | mm_live_ | Production access |
| Test | mm_test_ | Development and testing |
Key Permissions
API keys can be scoped to specific permissions:- Read - View data only
- Write - Create and update data
- Delete - Remove data
- Admin - Full access including settings
Revoking Keys
To revoke an API key:- Go to Settings > API
- Find the key you want to revoke
- Click Revoke
- Confirm the action
Revoked keys stop working immediately. Any applications using the key will receive 401 errors.
Best Practices
Use separate keys for different applications
Rotate keys regularly (every 90 days recommended)
Use the minimum permissions required
Store keys in environment variables, not code
Monitor key usage for unusual activity