What you'll need
- Global Administrator or Application Administrator access to your Microsoft 365 tenant
- SharePoint Administrator or Site Collection Administrator access to the target site
- Around 15–20 minutes to complete the setup
- The SharePoint site URL where you want to publish
Overview
The SharePoint connector publishes standardized work instructions from Maestro directly into SharePoint as modern pages. Published pages appear in your site navigation and are fully searchable.
What this connector does
- Creates real SharePoint pages, not just uploaded files
- Adds pages to your site navigation
- Keeps content fully searchable within SharePoint
- Uses SharePoint's modern page layout
What gets exported
- Numbered, step-by-step instructions
- Required tools & materials per step
- Safety notes and warnings
- Project and organization metadata
Step-by-step setup
Create an Azure app registration
Register an application in Azure AD so Maestro can authenticate to your SharePoint sites.
Access the Azure portal
- Go to the Azure portal and sign in with a Global or Application Administrator account.
- Navigate to Azure Active Directory → App registrations.
- Click New registration.
Configure the registration
| Field | Value |
|---|---|
| Name | Maestro — SharePoint Integration |
| Supported account types | Accounts in this organizational directory only |
| Redirect URI | Leave blank for now |
Click Register, then note the Application (client) ID and Directory (tenant) ID — you'll need them later.
Keep these IDs handy
You'll enter both when configuring the connector in Maestro. They're safe to store, but don't post them publicly.
Create a client secret
Generate a secret Maestro will use to authenticate with your SharePoint sites.
- In your app registration, open Certificates & secrets.
- Click New client secret.
- Enter a description (e.g.
Maestro connector) and set expiry to 24 months (recommended). - Click Add.
Copy the secret value now
Copy the secret value immediately — Azure won't show it again after you leave the page. If you lose it, you'll need to generate a new one.
Configure API permissions
Add required permissions
- Open API permissions → Add a permission.
- Select Microsoft Graph → Application permissions.
- Search for and add the permissions below, then click Add permissions.
| Permission | Type | Purpose |
|---|---|---|
Sites.ReadWrite.All | Application | Read & write pages and files on your sites |
Sites.Manage.All | Application | Create the libraries pages are published into |
Sites.FullControl.All | Application | Full control over SharePoint sites |
Grant admin consent
- Click Grant admin consent for [your organization].
- Confirm, then verify each permission shows a green check under Status.
Only Global or Application Administrators can grant admin consent for these permissions.
Prepare the SharePoint site
Make sure the destination site is ready to receive published instructions.
- Navigate to the site where you want to publish.
- Confirm you have Site Collection Administrator or Owner rights.
- Copy the full site URL, e.g.
https://yourcompany.sharepoint.com/sites/WorkInstructions.
Site requirements
| Requirement | Status | Action |
|---|---|---|
| Modern site experience | Automatic | No action needed |
| Site Pages library | Automatic | Created by SharePoint |
| Page-creation permissions | Manual | Ensure the app has permission |
Modern SharePoint sites auto-support page creation through the Microsoft Graph API — no extra configuration is needed on the site itself.
Configure the connector in Maestro
Open connector settings
- In Maestro, go to Organization → Connectors.
- Find SharePoint and click Connect.
Enter configuration details
| Field | Value | Where to find it |
|---|---|---|
| Tenant ID | Your Azure AD tenant ID | App registration → Overview → Directory (tenant) ID |
| Client ID | Your app registration client ID | App registration → Overview → Application (client) ID |
| Client secret | The secret from Step 2 | The value you copied when creating the secret |
| Site URL | Your SharePoint site URL | Full URL of your SharePoint site |
Click Test connection, verify it succeeds, then Save connector.
Troubleshooting
If the test fails, double-check your credentials and confirm all API permissions have been granted admin consent (Step 3).
Publish a test instruction
Send from Maestro
- Open a standardized work instruction in your Library.
- Choose Send, select SharePoint as the destination, and confirm.
Verify in SharePoint
- Go to your SharePoint site → Site Contents → Site Pages.
- Open the exported page and confirm formatting, step numbers, and content render correctly.
Success
Your instruction appears as a modern SharePoint page with formatting, step numbers, and content intact. You're all set to publish.
Troubleshooting
"Invalid request" error when creating pages
Usually a permissions problem, though it can also mean the site doesn't support modern pages.
Confirm all three permissions are granted — Sites.ReadWrite.All, Sites.Manage.All and Sites.FullControl.All — and that admin consent shows a green check in Azure. Then check the site URL is correct and reachable, and that the app registration hasn't expired. Re-run Test connection after granting.
Authentication or access-token errors
The tenant ID, client ID or client secret may be wrong, or the secret may have expired.
Double-check all three in your connector settings and confirm the secret hasn't expired in the Azure portal. If the app registration was deleted or disabled, or you can't find the secret value, generate a new secret (Step 2) and re-enter it.
Pages created as files instead of SharePoint pages
This is the intended fallback. If the modern pages API fails, Maestro publishes an HTML file to the Documents library instead, so the content still lands and stays searchable.
To get true SharePoint pages, confirm the permissions in Step 3 are all granted and that the site uses the modern experience.
Next steps
Train your team
Show your team how to send instructions to SharePoint and how to find them once they're live.
Security review
Periodically review and rotate the client secret, monitor connector usage, and confirm permissions stay appropriate.
Need more help?
If your issue isn't covered here, reach out with your setup details and any error messages you're seeing.