> ## 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 GoCardless with API Key – StackOne Hub

> Link a GoCardless account in the StackOne Hub using API Key. End-user guide to authorize the integration and start using GoCardless actions.

<Warning>Access tokens are for using your own GoCardless account with the API. For partner integrations to manage other users' accounts, use OAuth 2.0 instead. Ensure you are using the correct environment token (Sandbox tokens only work with sandbox API, live tokens only work with live API).</Warning>

<section data-guide-section data-guide-scopes="">
  <h2>Creating Your GoCardless Access Token</h2>

  <p>GoCardless uses Bearer token authentication for API access. Follow these steps to create an access token from your GoCardless Dashboard.</p>

  <Steps>
    <Step title="Sign in to GoCardless Dashboard">
      <div data-guide-step data-guide-scopes="" data-guide-display-scopes-list="">
        <p>Sign in to your <a href="https://manage.gocardless.com" target="_blank" rel="noopener noreferrer">GoCardless Dashboard</a> (or <a href="https://manage-sandbox.gocardless.com" target="_blank" rel="noopener noreferrer">Sandbox Dashboard</a> for testing).</p>
      </div>
    </Step>

    <Step title="Navigate to API Settings">
      <div data-guide-step data-guide-scopes="" data-guide-display-scopes-list="">
        <p>In the left sidebar, click <strong>Developers</strong>, then select <strong>API settings</strong>.</p>
      </div>
    </Step>

    <Step title="Open Access Tokens">
      <div data-guide-step data-guide-scopes="" data-guide-display-scopes-list="">
        <p>You will see the <strong>Access tokens</strong> page with a list of your existing tokens (if any).</p>
      </div>
    </Step>

    <Step title="Create Access Token">
      <div data-guide-step data-guide-scopes="" data-guide-display-scopes-list="">
        <p>Click the <strong>Create access token</strong> button in the top right corner.</p>
      </div>
    </Step>

    <Step title="Configure Token Details">
      <div data-guide-step data-guide-scopes="" data-guide-display-scopes-list="">
        <p>In the modal dialog, provide the following details for your token.</p>

        <ul>
          <li><strong>Name</strong> - Enter a descriptive name for the token (e.g., 'StackOne Integration')</li>
          <li><strong>Scope</strong> - Select the appropriate access level:</li>
          <li>  • <strong>Read only access</strong> - For read-only operations</li>
          <li>  • <strong>Read-write access</strong> - For full API access (create, update, delete operations)</li>
        </ul>
      </div>
    </Step>

    <Step title="Save and Copy Token">
      <div data-guide-step data-guide-scopes="" data-guide-display-scopes-list="">
        <p>Click <strong>Create</strong> to generate the token.</p>

        <ul>
          <li>Copy the token immediately as it will only be shown once</li>
          <li>Store the token securely</li>
        </ul>
      </div>
    </Step>

    <Step title="Select Environment in StackOne">
      <div data-guide-step data-guide-scopes="" data-guide-display-scopes-list="">
        <p>When connecting in StackOne, choose the environment that matches your token type.</p>

        <ul>
          <li><strong>Production</strong> - Use live tokens (starting with `live_`) for real payments</li>
          <li><strong>Sandbox</strong> - Use sandbox tokens (starting with `sandbox_`) for testing</li>
        </ul>
      </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>Access Token</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>