> ## Documentation Index
> Fetch the complete documentation index at: https://docs.stackone.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Connect Orderspace with OAuth 2.0 – StackOne Hub

> Link a Orderspace account in the StackOne Hub using OAuth 2.0. End-user guide to authorize the integration and start using Orderspace actions.

<Warning>You must sign in as an <strong>Admin User</strong> in Orderspace to create a Custom Integration. Sales Rep accounts cannot access the admin site, so the Integrations page is not available to them. If you do not have admin access, ask an account owner or admin to either create the integration on your behalf and share the Client ID / Client Secret, or grant you admin access first.</Warning>

<section data-guide-section data-guide-scopes="">
  <h2>Create a Custom Integration</h2>

  <p>Create a Custom Integration in the Orderspace admin to issue an OAuth2 Client ID and Client Secret.</p>

  <Steps>
    <Step title="Sign in to Orderspace">
      <div data-guide-step data-guide-scopes="" data-guide-display-scopes-list="">
        <p>Sign in to your Orderspace admin account as an admin user. Orderspace uses tenant-specific subdomains, so the admin portal is at `https://<your-tenant>.orderspace.com/admin` (for example, `https://acme.orderspace.com/admin`).<br /><br /><strong>Note:</strong> If you are unsure of your tenant URL, check your welcome email (it is usually included there) or ask your Orderspace administrator.</p>
      </div>
    </Step>

    <Step title="Open Integrations">
      <div data-guide-step data-guide-scopes="" data-guide-display-scopes-list="">
        <p>From the left sidebar, select <strong>Integrations</strong>.</p>
      </div>
    </Step>

    <Step title="Create a New Custom Integration">
      <div data-guide-step data-guide-scopes="" data-guide-display-scopes-list="">
        <p>Under the <strong>Custom Integrations</strong> section, click <strong>New Custom Integration</strong>.</p>

        <ul>
          <li>Set the <strong>Integration Name</strong> (e.g. `StackOne Integration`).</li>
          <li>Set the <strong>Developer Email Address</strong> for contact about API changes.</li>
          <li>Click <strong>Create Integration</strong> to generate the credentials. The integration is persisted at this point — no separate save step is required. The <strong>Save Changes</strong> button shown afterwards is only used if you later edit the integration name or email.</li>
        </ul>
      </div>
    </Step>

    <Step title="Copy credentials">
      <div data-guide-step data-guide-scopes="" data-guide-display-scopes-list="">
        <p>Once created, Orderspace will display the <strong>Client ID</strong> and <strong>Client Secret</strong>. Copy them and store them securely - they will be used to authenticate API requests. You can also revisit the integration later to view them again.</p>
      </div>
    </Step>

    <Step title="Wait for the credentials to activate">
      <div data-guide-step data-guide-scopes="" data-guide-display-scopes-list="">
        <p>Newly created Custom Integration credentials are not active immediately. Allow <strong>10-15 minutes</strong> for Orderspace to propagate them before attempting to connect — using them too early will result in an authentication error. If you see an auth failure right after creation, wait and retry rather than regenerating the credentials.</p>
      </div>
    </Step>
  </Steps>
</section>

<div data-whitelabel-hide>
  <h2>Linking the Account from the Hub</h2>

  <Steps>
    <Step title="Navigate to the Hub">
      Use one of the three <a href="/guides/accounts-section#linking-accounts">Linking Account Methods</a> to access the Hub.
    </Step>

    <Step title="Fill out the fields">
      Fill out the following fields using details from your provider:

      <ul>
        <li><strong>Client ID</strong></li>
        <li><strong>Client Secret</strong></li>
      </ul>
    </Step>

    <Step title="Connect">
      <ul>
        <li>Click <strong>Connect</strong></li>
        <li>If applicable, the provider will redirect you to a sign-in or authorization page. Complete the provider's authorization flow.</li>
        <li>Once authorization is successful, you will see a confirmation popup</li>
      </ul>
    </Step>
  </Steps>

  <p>If the account linking is successful, you will see the newly linked account in your <a href="/guides/accounts-section">Accounts</a> page.</p>
</div>

## Next Steps

<Columns cols={2}>
  <Card title="Webhooks setup" href="/connectors/orderspace/guides/webhook-setup">
    <p className="connector-page-auth-description" style={{ fontSize: '14px', marginTop: 0, marginBottom: 0 }}>
      Configure receiving Events for Orderspace into StackOne.
    </p>
  </Card>
</Columns>