Skip to content
Build a Doc
Home Documentation Support
This documentation is currently in preview, therefore subject to change.

Generate an API Key

You’ll achieve: A working API key ready to use in Power Automate.

Before You Start

You need:

  • An active Build a Doc subscription
  • Portal access with Admin or Member role

How to Create Your API Key

  1. Sign in to the Build a Doc portal
  2. Click API Keys in the left menu
  3. Click Create New Key
  4. Enter a descriptive name (e.g., Production-Invoice-Flow)
  5. Click Create

Success: Your API key is generated.

How to Copy and Store Your Key Securely

  1. Copy the entire key immediately
  2. Store it securely in:
    • ✅ Password manager (recommended)
    • ✅ Azure Key Vault
    • ❌ NOT in plain text files
    • ❌ NOT in source code
    • ❌ NOT in emails or chat

Success: Your API key is safely stored.

How to Use Your Key in Power Automate

  1. Open Power Automate
  2. Add a Build a Doc action
  3. When prompted for connection:
    • Click Create new connection
    • Paste your API key
    • Name the connection something descriptive
    • Click Create

Success: Your flow is authenticated.

How to Name Your Keys

Use clear names that indicate:

  • Environment: Production, Development, Testing
  • Purpose: Invoice-Flow, Report-Generator
  • Team: Finance-Team, HR-Automation

Examples:

  • ✅ Production-Invoice-Flow
  • ✅ Dev-Testing-Finance-Team
  • ❌ Key1
  • ❌ MyKey

How to Troubleshoot a Non-Working Key

Problem: Flow fails with authentication error

  1. Verify the key was copied correctly (no extra spaces)
  2. Check key status in portal (not revoked)
  3. Verify subscription is active
  4. Try creating a new key

Problem: Lost your API key

  1. You cannot retrieve it - keys are never shown again
  2. Create a new key
  3. Update your Power Automate connections
  4. Revoke the lost key in the portal

What You’ve Achieved

You now have:

  • A working API key
  • Secure storage for your key
  • Knowledge of how to use it in Power Automate