Manage API Keys
API keys authenticate your Power Platform connector requests. Manage them securely through the Build a Doc portal.
Creating an API Key
- Sign in to the Build a Doc portal
- Navigate to API Keys
- Click Create New Key
- Enter a descriptive name (e.g., “Production Flow”, “Dev Testing”)
- Click Create
- Copy the key immediately - it won’t be shown again
API Key Best Practices
Naming Convention
Use descriptive names that indicate:
- Environment (prod, dev, test)
- Purpose (invoice-flow, report-generator)
- Owner/team (finance-team, hr-automation)
Key Management
| Do | Don’t |
|---|---|
| Use separate keys for different purposes | Share one key across all uses |
| Rotate keys periodically | Keep keys indefinitely |
| Revoke unused keys | Leave old keys active |
| Store keys in secure locations | Store keys in plain text |
Rotating API Keys
To rotate a key without service disruption:
- Create a new API key
- Update your Power Automate connections with the new key
- Test your flows to confirm they work
- Revoke the old key
Revoking API Keys
If a key is compromised or no longer needed:
- Go to API Keys in the portal
- Find the key to revoke
- Click Revoke or Delete
- Confirm the action
What happens:
- Key is immediately invalidated
- Flows using this key will fail with 401 errors
- Action cannot be undone
Managing Multiple Keys
When to Use Multiple Keys
- Separate environments (production vs. development)
- Different teams or departments
- Different applications or workflows
- Auditing and tracking purposes
Tracking Key Usage
Name keys clearly to track:
- Which flows use which keys
- When keys were created
- Who owns each key
Troubleshooting
Key Not Working
- Verify key is copied correctly (no extra spaces)
- Check key status in portal (not revoked)
- Verify subscription is active
- Try creating a new key
Lost API Key
If you’ve lost your API key:
- You cannot retrieve it
- Create a new key
- Update your connections
- Revoke the lost key (if you know which one)