> ## Documentation Index
> Fetch the complete documentation index at: https://stackone-hub-docs-confluence-api-token-update.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Xyleme

> If you've been directed to StackOne to integrate with Xyleme, the following steps will help you understand the process and any necessary actions to configure successful integration.

<Warning>
  This guidance assumes you have Admin privileges for your Xyleme account.
</Warning>

## Gather System Account Credentials

<Steps>
  <Step title="Log in to Xyleme">
    Log in to your Xyleme account.
    Your domain (tenant) is the subdomain used to access Xyleme. For example, if your URL is `https://my-domain.bravais.com/adminportal`, your domain is `my-domain`.

    <Frame>
      <img className="rounded-md" style={{ margin: '0 auto', border: '1px solid #efefef' }} alt="Tenant Domain" src="https://mintcdn.com/stackone-hub-docs-confluence-api-token-update/w__eN0U5iLwN8ehP/images/xyleme/image1.png?fit=max&auto=format&n=w__eN0U5iLwN8ehP&q=85&s=712611a44d7cdcce3fb0f7fdff347f1d" width="2298" height="1436" data-path="images/xyleme/image1.png" />
    </Frame>
  </Step>

  <Step title="Create System Account">
    From the top navigation bar, open the **Admin Portal** dropdown to confirm you’re in the Admin Portal.
    Next, open the **Users** dropdown and select **Users** to access the user management page.
    On the Users page, click **Add user** to start creating a new user.

    <Frame>
      <img className="rounded-md" style={{ margin: '0 auto', border: '1px solid #efefef' }} alt="Create System Account" src="https://mintcdn.com/stackone-hub-docs-confluence-api-token-update/w__eN0U5iLwN8ehP/images/xyleme/image2.png?fit=max&auto=format&n=w__eN0U5iLwN8ehP&q=85&s=b940f9130bd1720612ed7e0c2440a965" width="1221" height="355" data-path="images/xyleme/image2.png" />
    </Frame>
  </Step>

  <Step title="Enter User Details and Save">
    In the **Add user** dialog, fill in the user’s **First name**, **Last name**, and **Email**.
    Once all fields are completed, click **Save** to add the user to Xyleme.

    <Frame>
      <img className="rounded-md" style={{ margin: '0 auto', border: '1px solid #efefef' }} alt="Enter user details and save" src="https://mintcdn.com/stackone-hub-docs-confluence-api-token-update/w__eN0U5iLwN8ehP/images/xyleme/image3.png?fit=max&auto=format&n=w__eN0U5iLwN8ehP&q=85&s=105c52d7db98ba970b73c92d7dd548dc" width="578" height="376" data-path="images/xyleme/image3.png" />
    </Frame>
  </Step>

  <Step title="Search for the User and Open Details">
    Return to the **Users** page and use the **Search users** box to find the user you just created.
    Enter part of the user’s name or email and click the search icon.
    In the results list, click the **three-dot menu** next to the correct user and select **View details**. This opens the user’s detail page.

    <Frame>
      <img className="rounded-md" style={{ margin: '0 auto', border: '1px solid #efefef' }} alt="Search for the user and open details" src="https://mintcdn.com/stackone-hub-docs-confluence-api-token-update/w__eN0U5iLwN8ehP/images/xyleme/image4.png?fit=max&auto=format&n=w__eN0U5iLwN8ehP&q=85&s=18c96fd5c66c6cc9155836cd1c1a96ad" width="1205" height="514" data-path="images/xyleme/image4.png" />
    </Frame>
  </Step>

  <Step title="Set Username and Password">
    On the user’s profile page, ensure the **Identities** tab is selected.
    Under **Local Identity**, add and copy the **Username** shown — this will be used as the system account’s login.
    Enter a strong password in both the **New password** and **Re-type new password** fields.
    Click **Save** to finalize the username and password for this account.

    <Frame>
      <img className="rounded-md" style={{ margin: '0 auto', border: '1px solid #efefef' }} alt="Set username and password" src="https://mintcdn.com/stackone-hub-docs-confluence-api-token-update/w__eN0U5iLwN8ehP/images/xyleme/image5.png?fit=max&auto=format&n=w__eN0U5iLwN8ehP&q=85&s=aea6df62d3aefe17000b5f8bb8887379" width="1229" height="711" data-path="images/xyleme/image5.png" />
    </Frame>

    Record the `Username` and `Password` associated with this system account for use in the next steps.
  </Step>
</Steps>

## Linking Your Account

Use your domain and system account credentials to connect Xyleme with StackOne.

<Steps>
  <Step title="Link Xyleme Account">
    In the connection modal, enter the `Domain` (tenant), `Username`, and `Password`.

    <Frame>
      <img className="rounded-md" style={{ margin: '0 auto', border: '1px solid #efefef' }} alt="Link Account" src="https://mintcdn.com/stackone-hub-docs-confluence-api-token-update/w__eN0U5iLwN8ehP/images/xyleme/image6.png?fit=max&auto=format&n=w__eN0U5iLwN8ehP&q=85&s=cf6d0e65d990cf28813bf4fd6c98ae2c" width="497" height="797" data-path="images/xyleme/image6.png" />
    </Frame>

    Click `Connect`.
  </Step>
</Steps>

<br />

Congratulations, you're all set! If you face any issues with the steps mentioned above,
please contact us by emailing [integrations@stackone.com](mailto:integrations@stackone.com). We're always here to assist you!

## Useful Links

<Card title="Xyleme Syndicate API Reference Documentation" icon="link" href="https://api-docs.xyleme.com/">
  [https://api-docs.xyleme.com/](https://api-docs.xyleme.com/)
</Card>