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

# Sitecore Content Hub Integration

> Connect Gradial's AI agents to Sitecore Content Hub to automate asset management, content creation, and campaign workflows via REST APIs.

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 a new Content Hub integration

<Steps>
  <Step title="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.

    <img src="https://mintcdn.com/gradial/i3r9ZApLQjXSknQe/images/CHOnboardCreateNewUserAccount.png?fit=max&auto=format&n=i3r9ZApLQjXSknQe&q=85&s=699f8f6ed24429914894cf6fda605fa4" alt="CH Onboard Create New User Account Pn" width="2536" height="731" data-path="images/CHOnboardCreateNewUserAccount.png" />
  </Step>

  <Step title="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.

    <img src="https://mintcdn.com/gradial/i3r9ZApLQjXSknQe/images/CHOnboardCreateanAPIToken.png?fit=max&auto=format&n=i3r9ZApLQjXSknQe&q=85&s=5c75f621a61416b87f33ccb376edc08a" alt="CH Onboard Createan API Token Pn" width="512" height="298" data-path="images/CHOnboardCreateanAPIToken.png" />

    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.

    <img src="https://mintcdn.com/gradial/i3r9ZApLQjXSknQe/images/CHOnboardConfirmAPIToken.png?fit=max&auto=format&n=i3r9ZApLQjXSknQe&q=85&s=847e78c6872b8f29fbe12723bdfdeced" alt="CH Onboard Confirm API Token Pn" width="635" height="237" data-path="images/CHOnboardConfirmAPIToken.png" />
  </Step>

  <Step title="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.

          <img src="https://mintcdn.com/gradial/i3r9ZApLQjXSknQe/images/CHOnboardInfoIcon.png?fit=max&auto=format&n=i3r9ZApLQjXSknQe&q=85&s=ca9b61fbb9bfab6ad93b68e2c9e8f20d" alt="CH Onboard Info Icon Pn" width="460" height="262" data-path="images/CHOnboardInfoIcon.png" />

          <img src="https://mintcdn.com/gradial/i3r9ZApLQjXSknQe/images/CHOnboardEnsureSufficientPermissions.png?fit=max&auto=format&n=i3r9ZApLQjXSknQe&q=85&s=027bfabb60c1c23bcc733c9fcdf3411c" alt="CH Onboard Ensure Sufficient Permissions Pn" width="1346" height="663" data-path="images/CHOnboardEnsureSufficientPermissions.png" />

    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.

    <img src="https://mintcdn.com/gradial/i3r9ZApLQjXSknQe/images/CHOnboardEmailVerification.png?fit=max&auto=format&n=i3r9ZApLQjXSknQe&q=85&s=ab1cad00d1366c54f2666b23c5679967" alt="CH Onboard Email Verification Pn" width="1440" height="395" data-path="images/CHOnboardEmailVerification.png" />

    When setup is complete, the user account will display a single **"API User"** tag:

    <img src="https://mintcdn.com/gradial/i3r9ZApLQjXSknQe/images/CHOnboardFinalCheck.png?fit=max&auto=format&n=i3r9ZApLQjXSknQe&q=85&s=4a4d5e8e451f01115fbe7d652e844362" alt="CH Onboard Final Check Pn" width="1848" height="452" data-path="images/CHOnboardFinalCheck.png" />
  </Step>

  <Step title="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.

    <img src="https://mintcdn.com/gradial/i3r9ZApLQjXSknQe/images/CHOnboardConnectionCreation.png?fit=max&auto=format&n=i3r9ZApLQjXSknQe&q=85&s=4eb3b05382f1d44513d5bb54e4c17944" alt="CH Onboard Connection Creation Pn" width="1161" height="979" data-path="images/CHOnboardConnectionCreation.png" />
  </Step>
</Steps>