Skip to main content
Gradial integrates with Sitecore XM Cloud and Content Hub to enable AI marketing workflows like updating a web page, launching a new campaign, creating email assets, bulk updates across an XM Cloud site, and many more. Select the product you want to connect below.

Sitecore XM Cloud

Connect Gradial to Sitecore XM Cloud using a guided setup wizard with live credential validation and site selection

Sitecore Content Hub

Connect Gradial to Sitecore Content Hub using a dedicated API user account

​
Create a new Sitecore integration

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.
1

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
2

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.
3

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.
4

Save

Review your configuration and click Create Connection. Gradial stores the connection details along with the selected site configuration.Once saved, the integration is available to connect to environments and projects within Gradial.

​
Create a new Content Hub integration

Gradial connects with Content Hub via its published REST APIs to enable AI marketing workflows such as uploading new assets, creating Content Items, and managing Campaigns within Content Hub. To enable this integration, Gradial requires a dedicated Content Hub user account with API access. You can either create a new user account or configure an existing one. Create or configure a Content Hub user Open the Content Hub Admin Console, typically located at: https://{your-hostname}/{your-locale}/admin From the Users page, select New User to add an account with access to the necessary modules. CH Onboard Create New User Account Pn Grant API access Enable the user account to interact with the Content Hub APIs by making it an API User:
  • In the Users dashboard, click the key shield icon on the right-hand side.
  • In the modal that appears, select New Token.
You do not need to copy this token — once the account is designated as an API User, Gradial Agents will be able to generate new tokens automatically. CH Onboard Createan API Token Pn If you are updating an existing account that already has API access, a modal will indicate the current API User status. No further action is required. CH Onboard Confirm API Token Pn Configure permissions and password Ensure that the user account has a configured password and the correct permissions:
  • Click the information icon on the right-hand side of the Users dashboard.
  • Under the User Groups tab, verify the account’s permissions for creating, reading, updating, and deleting entities. Typically, the Superusers Group and Policy encompass these permissions.
  • In the Details tab, assign a valid email address to the account. This step is required to configure a password.
CH Onboard Info Icon Pn CH Onboard Ensure Sufficient Permissions Pn Until the email is verified and a password is created, you will see an “Email Not Verified” tag on the user account. If you encounter difficulty setting a password, ensure it contains both letters and numbers. CH Onboard Email Verification Pn When setup is complete, the user account will display a single “API User” tag: CH Onboard Final Check Pn Connect Content Hub to Gradial In Gradial:
  1. Sign in and navigate to Settings > Integrations.
  2. Enter the hostname of your Content Hub environment along with the Username and Password of the configured Content Hub user account.
  3. Click Validate Connection to confirm permissions and ensure Gradial can authenticate.
  4. Once verified, select Create Connection to complete the integration.
You can now connect your Content Hub integration to environments and projects within Gradial. CH Onboard Connection Creation Pn