Five Number tools
Five Number tools › Graph Connector Schema Builder

Microsoft Graph Connector Schema Builder

Build the connection and schema JSON for a Microsoft Graph connector (Copilot connector) from a simple form, or paste a schema to validate it against the property types, flags, labels and the searchable / refinable rules.

Nothing you type is sent anywhere. It all runs in your browser.

Connection

0 / 32

3 to 32 letters and digits only. Cannot start with “Microsoft” or be a reserved value.

0 / 128

Helps Copilot understand the nature of the content.

Schema properties

1 to 128 properties. Flags: S searchable, Q queryable, R retrievable, Rf refinable. Searchable and refinable can’t both be on, and only String and StringCollection can be searchable.

Output

Schema — PATCH /external/connections/{id}/schema

            
Connection — POST /external/connections

            

What this checks

  • Connection id: 3 to 32 alphanumeric characters, can’t start with Microsoft or be a reserved value (SharePoint, Teams, Exchange, and so on).
  • Schema: baseType must be microsoft.graph.externalItem, with 1 to 128 properties.
  • Property name: up to 32 characters, letters and digits only.
  • Searchable and refinable are mutually exclusive; only String and StringCollection can be searchable.
  • Labels should be mapped only to retrievable properties, and each label to a single property.
  • A core linter for the documented rules, not the full Graph validation. Confirm against the connector schema docs and register with the Graph API.

Disclaimer

These tools are provided free and as-is, with no warranty of any kind. Results are best-effort and can be incomplete or out of date, so always verify them against official Microsoft documentation before you act on them.

fivenumber tools is an independent project and is not affiliated with, sponsored by, or endorsed by Microsoft. Microsoft, Microsoft 365, SharePoint, Entra, OneDrive and Copilot are trademarks of the Microsoft group of companies.

Send feedback

Found this useful, or hit a snag? Tell me what worked and what would make it better. Your note comes straight to me.

Thanks, your feedback was sent.

I read every note. If you left your email, I may follow up.