SharePoint integration setup

Connect Maestro to Microsoft SharePoint to publish standardized work instructions as modern SharePoint pages.

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

1

Create an Azure app registration

Register an application in Azure AD so Maestro can authenticate to your SharePoint sites.

Access the Azure portal

  1. Go to the Azure portal and sign in with a Global or Application Administrator account.
  2. Navigate to Azure Active Directory → App registrations.
  3. Click New registration.

Configure the registration

FieldValue
NameMaestro — SharePoint Integration
Supported account typesAccounts in this organizational directory only
Redirect URILeave 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.

2

Create a client secret

Generate a secret Maestro will use to authenticate with your SharePoint sites.

  1. In your app registration, open Certificates & secrets.
  2. Click New client secret.
  3. Enter a description (e.g. Maestro connector) and set expiry to 24 months (recommended).
  4. 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.

3

Configure API permissions

Add required permissions

  1. Open API permissions → Add a permission.
  2. Select Microsoft Graph → Application permissions.
  3. Search for and add the permissions below, then click Add permissions.
PermissionTypePurpose
Sites.ReadWrite.AllApplicationRead & write pages and files on your sites
Sites.Manage.AllApplicationCreate the libraries pages are published into
Sites.FullControl.AllApplicationFull control over SharePoint sites

Grant admin consent

  1. Click Grant admin consent for [your organization].
  2. Confirm, then verify each permission shows a green check under Status.

Only Global or Application Administrators can grant admin consent for these permissions.

4

Prepare the SharePoint site

Make sure the destination site is ready to receive published instructions.

  1. Navigate to the site where you want to publish.
  2. Confirm you have Site Collection Administrator or Owner rights.
  3. Copy the full site URL, e.g. https://yourcompany.sharepoint.com/sites/WorkInstructions.

Site requirements

RequirementStatusAction
Modern site experienceAutomaticNo action needed
Site Pages libraryAutomaticCreated by SharePoint
Page-creation permissionsManualEnsure 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.

5

Configure the connector in Maestro

Open connector settings

  1. In Maestro, go to Organization → Connectors.
  2. Find SharePoint and click Connect.

Enter configuration details

FieldValueWhere to find it
Tenant IDYour Azure AD tenant IDApp registration → Overview → Directory (tenant) ID
Client IDYour app registration client IDApp registration → Overview → Application (client) ID
Client secretThe secret from Step 2The value you copied when creating the secret
Site URLYour SharePoint site URLFull 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).

6

Publish a test instruction

Send from Maestro

  1. Open a standardized work instruction in your Library.
  2. Choose Send, select SharePoint as the destination, and confirm.

Verify in SharePoint

  1. Go to your SharePoint site → Site Contents → Site Pages.
  2. 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.

Contact support