Gradial AI agents connect with XM Cloud via Sitecore’s published GraphQL and REST APIs. The integration is configured through a guided 4-step wizard in Gradial under Settings → Integrations.Documentation Index
Fetch the complete documentation index at: https://docs.gradial.com/llms.txt
Use this file to discover all available pages before exploring further.
Create a new Sitecore XM Cloud integration
Connection Details
Provide basic information about the XM Cloud environment:
- Connection Name — A human-readable label for this environment, e.g. “Staging” or “Production”
- Sitecore XM Cloud Hostname — The hostname of the XM Cloud environment. Open the Content Editor in XM Cloud and copy the URL hostname, e.g.
https://xmc-grd409a-grdx303433-dev1f80.sitecorecloud.io - Description (optional) — A short note to help your team identify this connection
Credentials
Enter the Username and Password for a Sitecore user account with sufficient permissions to access the XM Cloud APIs.Gradial validates the credentials live against your XM Cloud environment before allowing you to proceed. If validation fails, double-check that the account has API access and that the hostname is correct.
Site Selection
After successful credential validation, Gradial queries your XM Cloud environment and presents a dropdown list of all accessible sites.Select the site that Gradial agents should target by default. Gradial automatically resolves the correct Editing Host URL for the chosen site — no manual entry required.
The selected site is saved as the Default Site for this connection. Both authoring and QA agents will use this site when executing tasks, unless overridden at the task level.