Configure the Power Platform Connector
This guide explains how to configure the Build a Doc connector for use in Power Automate and Power Apps.
Prerequisites
- A Build a Doc subscription
- An API key from the Build a Doc portal (see Generate an API Key)
- Power Automate or Power Apps access with permissions to create connections
Adding the Connector
In Power Automate
- Create a new flow or edit an existing one
- Add a new action
- Search for “HappyWired PowerDocs” or “Build a Doc”
- Select the desired action (e.g., Convert Word Document)
In Power Apps
- Open your app in edit mode
- Go to Data → Add data
- Search for “HappyWired PowerDocs”
- Add the connector
Creating the Connection
When you first use a Build a Doc action, you’ll be prompted to create a connection:
- Click + Add new connection when prompted
- Enter a Connection name (e.g., “Build a Doc - Production”)
- Paste your API key from the Build a Doc portal
- Click Create
Managing Connections
View Existing Connections
- Go to Power Automate
- Navigate to Data → Connections
- Find your Build a Doc connections
Update a Connection
To update an API key:
- Delete the existing connection
- Create a new connection with the new API key
- Update any flows using the old connection
Delete a Connection
- Navigate to Data → Connections
- Find the connection to delete
- Click the … menu → Delete
Connection Best Practices
| Practice | Reason |
|---|---|
| Use descriptive names | Easy identification |
| Use service accounts for shared flows | Avoid personal account dependencies |
| Rotate API keys periodically (see Manage API Keys) | Security hygiene | | Document which flows use which connections | Easier maintenance |
Troubleshooting
Connection Failed
- Verify the API key is correct (no extra spaces)
- Check that the API key is active in the portal
- Try using a private/incognito browser window
Connection Disappeared
- Check if the connection was deleted
- Verify you’re signed in with the correct account
- Re-create the connection if necessary