> ## 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. To build a partner integration that manages other users' accounts, use OAuth 2.0 instead. Tokens are environment-specific — a sandbox token only works with the Sandbox environment and a live token only with Production.</Warning>

<Panel>
  <div className="not-prose guides-scope-selector" data-guides-scope-selector data-guide-actions-json="[{&#x22;id&#x22;:&#x22;gocardless_create_billing_request_flow&#x22;,&#x22;label&#x22;:&#x22;Create Billing Request Flow&#x22;,&#x22;scopes&#x22;:[&#x22;read_write&#x22;]},{&#x22;id&#x22;:&#x22;gocardless_list_billing_requests&#x22;,&#x22;label&#x22;:&#x22;List Billing Requests&#x22;,&#x22;scopes&#x22;:[&#x22;read_only&#x22;]},{&#x22;id&#x22;:&#x22;gocardless_get_billing_request&#x22;,&#x22;label&#x22;:&#x22;Get Billing Request&#x22;,&#x22;scopes&#x22;:[&#x22;read_only&#x22;]},{&#x22;id&#x22;:&#x22;gocardless_create_billing_request&#x22;,&#x22;label&#x22;:&#x22;Create Billing Request&#x22;,&#x22;scopes&#x22;:[&#x22;read_write&#x22;]},{&#x22;id&#x22;:&#x22;gocardless_cancel_billing_request&#x22;,&#x22;label&#x22;:&#x22;Cancel Billing Request&#x22;,&#x22;scopes&#x22;:[&#x22;read_write&#x22;]},{&#x22;id&#x22;:&#x22;gocardless_fulfil_billing_request&#x22;,&#x22;label&#x22;:&#x22;Fulfil Billing Request&#x22;,&#x22;scopes&#x22;:[&#x22;read_write&#x22;]},{&#x22;id&#x22;:&#x22;gocardless_notify_billing_request_customer&#x22;,&#x22;label&#x22;:&#x22;Notify Billing Request Customer&#x22;,&#x22;scopes&#x22;:[&#x22;read_write&#x22;]},{&#x22;id&#x22;:&#x22;gocardless_collect_customer_details_billing_request&#x22;,&#x22;label&#x22;:&#x22;Collect Customer Details For Billing Request&#x22;,&#x22;scopes&#x22;:[&#x22;read_write&#x22;]},{&#x22;id&#x22;:&#x22;gocardless_collect_bank_account_billing_request&#x22;,&#x22;label&#x22;:&#x22;Collect Bank Account For Billing Request&#x22;,&#x22;scopes&#x22;:[&#x22;read_write&#x22;]},{&#x22;id&#x22;:&#x22;gocardless_confirm_payer_details_billing_request&#x22;,&#x22;label&#x22;:&#x22;Confirm Payer Details For Billing Request&#x22;,&#x22;scopes&#x22;:[&#x22;read_write&#x22;]},{&#x22;id&#x22;:&#x22;gocardless_fallback_billing_request&#x22;,&#x22;label&#x22;:&#x22;Fallback Billing Request To Direct Debit&#x22;,&#x22;scopes&#x22;:[&#x22;read_write&#x22;]},{&#x22;id&#x22;:&#x22;gocardless_list_creditors&#x22;,&#x22;label&#x22;:&#x22;List Creditors&#x22;,&#x22;scopes&#x22;:[&#x22;read_only&#x22;]},{&#x22;id&#x22;:&#x22;gocardless_get_creditor&#x22;,&#x22;label&#x22;:&#x22;Get A Single Creditor&#x22;,&#x22;scopes&#x22;:[&#x22;read_only&#x22;]},{&#x22;id&#x22;:&#x22;gocardless_update_creditor&#x22;,&#x22;label&#x22;:&#x22;Update A Creditor&#x22;,&#x22;scopes&#x22;:[&#x22;read_write&#x22;]},{&#x22;id&#x22;:&#x22;gocardless_list_creditor_bank_accounts&#x22;,&#x22;label&#x22;:&#x22;List Creditor Bank Accounts&#x22;,&#x22;scopes&#x22;:[&#x22;read_only&#x22;]},{&#x22;id&#x22;:&#x22;gocardless_get_creditor_bank_account&#x22;,&#x22;label&#x22;:&#x22;Get A Single Creditor Bank Account&#x22;,&#x22;scopes&#x22;:[&#x22;read_only&#x22;]},{&#x22;id&#x22;:&#x22;gocardless_create_creditor_bank_account&#x22;,&#x22;label&#x22;:&#x22;Create A Creditor Bank Account&#x22;,&#x22;scopes&#x22;:[&#x22;read_write&#x22;]},{&#x22;id&#x22;:&#x22;gocardless_disable_creditor_bank_account&#x22;,&#x22;label&#x22;:&#x22;Disable A Creditor Bank Account&#x22;,&#x22;scopes&#x22;:[&#x22;read_write&#x22;]},{&#x22;id&#x22;:&#x22;gocardless_list_customers&#x22;,&#x22;label&#x22;:&#x22;List Customers&#x22;,&#x22;scopes&#x22;:[&#x22;read_only&#x22;]},{&#x22;id&#x22;:&#x22;gocardless_get_customer&#x22;,&#x22;label&#x22;:&#x22;Get A Single Customer&#x22;,&#x22;scopes&#x22;:[&#x22;read_only&#x22;]},{&#x22;id&#x22;:&#x22;gocardless_create_customer&#x22;,&#x22;label&#x22;:&#x22;Create A Customer&#x22;,&#x22;scopes&#x22;:[&#x22;read_write&#x22;]},{&#x22;id&#x22;:&#x22;gocardless_update_customer&#x22;,&#x22;label&#x22;:&#x22;Update A Customer&#x22;,&#x22;scopes&#x22;:[&#x22;read_write&#x22;]},{&#x22;id&#x22;:&#x22;gocardless_delete_customer&#x22;,&#x22;label&#x22;:&#x22;Remove A Customer&#x22;,&#x22;scopes&#x22;:[&#x22;read_write&#x22;]},{&#x22;id&#x22;:&#x22;gocardless_list_customer_bank_accounts&#x22;,&#x22;label&#x22;:&#x22;List Customer Bank Accounts&#x22;,&#x22;scopes&#x22;:[&#x22;read_only&#x22;]},{&#x22;id&#x22;:&#x22;gocardless_get_customer_bank_account&#x22;,&#x22;label&#x22;:&#x22;Get A Single Customer Bank Account&#x22;,&#x22;scopes&#x22;:[&#x22;read_only&#x22;]},{&#x22;id&#x22;:&#x22;gocardless_create_customer_bank_account&#x22;,&#x22;label&#x22;:&#x22;Create A Customer Bank Account&#x22;,&#x22;scopes&#x22;:[&#x22;read_write&#x22;]},{&#x22;id&#x22;:&#x22;gocardless_update_customer_bank_account&#x22;,&#x22;label&#x22;:&#x22;Update A Customer Bank Account&#x22;,&#x22;scopes&#x22;:[&#x22;read_write&#x22;]},{&#x22;id&#x22;:&#x22;gocardless_disable_customer_bank_account&#x22;,&#x22;label&#x22;:&#x22;Disable A Customer Bank Account&#x22;,&#x22;scopes&#x22;:[&#x22;read_write&#x22;]},{&#x22;id&#x22;:&#x22;gocardless_list_events&#x22;,&#x22;label&#x22;:&#x22;List Events&#x22;,&#x22;scopes&#x22;:[&#x22;read_only&#x22;]},{&#x22;id&#x22;:&#x22;gocardless_get_event&#x22;,&#x22;label&#x22;:&#x22;Get Event&#x22;,&#x22;scopes&#x22;:[&#x22;read_only&#x22;]},{&#x22;id&#x22;:&#x22;gocardless_list_instalment_schedules&#x22;,&#x22;label&#x22;:&#x22;List Instalment Schedules&#x22;,&#x22;scopes&#x22;:[&#x22;read_only&#x22;]},{&#x22;id&#x22;:&#x22;gocardless_get_instalment_schedule&#x22;,&#x22;label&#x22;:&#x22;Get A Single Instalment Schedule&#x22;,&#x22;scopes&#x22;:[&#x22;read_only&#x22;]},{&#x22;id&#x22;:&#x22;gocardless_create_instalment_schedule_with_dates&#x22;,&#x22;label&#x22;:&#x22;Create Instalment Schedule With Dates&#x22;,&#x22;scopes&#x22;:[&#x22;read_write&#x22;]},{&#x22;id&#x22;:&#x22;gocardless_create_instalment_schedule_with_schedule&#x22;,&#x22;label&#x22;:&#x22;Create Instalment Schedule With Schedule&#x22;,&#x22;scopes&#x22;:[&#x22;read_write&#x22;]},{&#x22;id&#x22;:&#x22;gocardless_update_instalment_schedule&#x22;,&#x22;label&#x22;:&#x22;Update An Instalment Schedule&#x22;,&#x22;scopes&#x22;:[&#x22;read_write&#x22;]},{&#x22;id&#x22;:&#x22;gocardless_cancel_instalment_schedule&#x22;,&#x22;label&#x22;:&#x22;Cancel An Instalment Schedule&#x22;,&#x22;scopes&#x22;:[&#x22;read_write&#x22;]},{&#x22;id&#x22;:&#x22;gocardless_list_mandates&#x22;,&#x22;label&#x22;:&#x22;List Mandates&#x22;,&#x22;scopes&#x22;:[&#x22;read_only&#x22;]},{&#x22;id&#x22;:&#x22;gocardless_get_mandate&#x22;,&#x22;label&#x22;:&#x22;Get A Single Mandate&#x22;,&#x22;scopes&#x22;:[&#x22;read_only&#x22;]},{&#x22;id&#x22;:&#x22;gocardless_create_mandate&#x22;,&#x22;label&#x22;:&#x22;Create A Mandate&#x22;,&#x22;scopes&#x22;:[&#x22;read_write&#x22;]},{&#x22;id&#x22;:&#x22;gocardless_update_mandate&#x22;,&#x22;label&#x22;:&#x22;Update A Mandate&#x22;,&#x22;scopes&#x22;:[&#x22;read_write&#x22;]},{&#x22;id&#x22;:&#x22;gocardless_cancel_mandate&#x22;,&#x22;label&#x22;:&#x22;Cancel A Mandate&#x22;,&#x22;scopes&#x22;:[&#x22;read_write&#x22;]},{&#x22;id&#x22;:&#x22;gocardless_reinstate_mandate&#x22;,&#x22;label&#x22;:&#x22;Reinstate A Mandate&#x22;,&#x22;scopes&#x22;:[&#x22;read_write&#x22;]},{&#x22;id&#x22;:&#x22;gocardless_list_payments&#x22;,&#x22;label&#x22;:&#x22;List Payments&#x22;,&#x22;scopes&#x22;:[&#x22;read_only&#x22;]},{&#x22;id&#x22;:&#x22;gocardless_get_payment&#x22;,&#x22;label&#x22;:&#x22;Get A Single Payment&#x22;,&#x22;scopes&#x22;:[&#x22;read_only&#x22;]},{&#x22;id&#x22;:&#x22;gocardless_create_payment&#x22;,&#x22;label&#x22;:&#x22;Create A Payment&#x22;,&#x22;scopes&#x22;:[&#x22;read_write&#x22;]},{&#x22;id&#x22;:&#x22;gocardless_update_payment&#x22;,&#x22;label&#x22;:&#x22;Update A Payment&#x22;,&#x22;scopes&#x22;:[&#x22;read_write&#x22;]},{&#x22;id&#x22;:&#x22;gocardless_cancel_payment&#x22;,&#x22;label&#x22;:&#x22;Cancel A Payment&#x22;,&#x22;scopes&#x22;:[&#x22;read_write&#x22;]},{&#x22;id&#x22;:&#x22;gocardless_retry_payment&#x22;,&#x22;label&#x22;:&#x22;Retry A Payment&#x22;,&#x22;scopes&#x22;:[&#x22;read_write&#x22;]},{&#x22;id&#x22;:&#x22;gocardless_list_payout_items&#x22;,&#x22;label&#x22;:&#x22;List Payout Items&#x22;,&#x22;scopes&#x22;:[&#x22;read_only&#x22;]},{&#x22;id&#x22;:&#x22;gocardless_list_payouts&#x22;,&#x22;label&#x22;:&#x22;List Payouts&#x22;,&#x22;scopes&#x22;:[&#x22;read_only&#x22;]},{&#x22;id&#x22;:&#x22;gocardless_get_payout&#x22;,&#x22;label&#x22;:&#x22;Get A Single Payout&#x22;,&#x22;scopes&#x22;:[&#x22;read_only&#x22;]},{&#x22;id&#x22;:&#x22;gocardless_update_payout&#x22;,&#x22;label&#x22;:&#x22;Update A Payout&#x22;,&#x22;scopes&#x22;:[&#x22;read_write&#x22;]},{&#x22;id&#x22;:&#x22;gocardless_list_refunds&#x22;,&#x22;label&#x22;:&#x22;List Refunds&#x22;,&#x22;scopes&#x22;:[&#x22;read_only&#x22;]},{&#x22;id&#x22;:&#x22;gocardless_get_refund&#x22;,&#x22;label&#x22;:&#x22;Get Refund&#x22;,&#x22;scopes&#x22;:[&#x22;read_only&#x22;]},{&#x22;id&#x22;:&#x22;gocardless_create_refund&#x22;,&#x22;label&#x22;:&#x22;Create Refund&#x22;,&#x22;scopes&#x22;:[&#x22;read_write&#x22;]},{&#x22;id&#x22;:&#x22;gocardless_update_refund&#x22;,&#x22;label&#x22;:&#x22;Update Refund&#x22;,&#x22;scopes&#x22;:[&#x22;read_write&#x22;]},{&#x22;id&#x22;:&#x22;gocardless_run_scenario_simulator&#x22;,&#x22;label&#x22;:&#x22;Run Scenario Simulator&#x22;,&#x22;scopes&#x22;:[&#x22;read_write&#x22;]},{&#x22;id&#x22;:&#x22;gocardless_list_subscriptions&#x22;,&#x22;label&#x22;:&#x22;List Subscriptions&#x22;,&#x22;scopes&#x22;:[&#x22;read_only&#x22;]},{&#x22;id&#x22;:&#x22;gocardless_get_subscription&#x22;,&#x22;label&#x22;:&#x22;Get Subscription&#x22;,&#x22;scopes&#x22;:[&#x22;read_only&#x22;]},{&#x22;id&#x22;:&#x22;gocardless_create_subscription&#x22;,&#x22;label&#x22;:&#x22;Create Subscription&#x22;,&#x22;scopes&#x22;:[&#x22;read_write&#x22;]},{&#x22;id&#x22;:&#x22;gocardless_update_subscription&#x22;,&#x22;label&#x22;:&#x22;Update Subscription&#x22;,&#x22;scopes&#x22;:[&#x22;read_write&#x22;]},{&#x22;id&#x22;:&#x22;gocardless_pause_subscription&#x22;,&#x22;label&#x22;:&#x22;Pause Subscription&#x22;,&#x22;scopes&#x22;:[&#x22;read_write&#x22;]},{&#x22;id&#x22;:&#x22;gocardless_resume_subscription&#x22;,&#x22;label&#x22;:&#x22;Resume Subscription&#x22;,&#x22;scopes&#x22;:[&#x22;read_write&#x22;]},{&#x22;id&#x22;:&#x22;gocardless_cancel_subscription&#x22;,&#x22;label&#x22;:&#x22;Cancel Subscription&#x22;,&#x22;scopes&#x22;:[&#x22;read_write&#x22;]},{&#x22;id&#x22;:&#x22;gocardless_list_tax_rates&#x22;,&#x22;label&#x22;:&#x22;List Tax Rates&#x22;,&#x22;scopes&#x22;:[&#x22;read_only&#x22;]},{&#x22;id&#x22;:&#x22;gocardless_get_tax_rate&#x22;,&#x22;label&#x22;:&#x22;Get A Single Tax Rate&#x22;,&#x22;scopes&#x22;:[&#x22;read_only&#x22;]}]" style={{ borderRadius: '8px', padding: '16px', marginBottom: '24px' }}>
    <div className="guides-scope-selector__title" style={{ fontSize: '16px', fontWeight: '600', marginBottom: '12px' }}>Select Actions to adjust the guide</div>
    <div className="guides-scope-selector__muted" style={{ fontSize: '13px', marginBottom: '12px' }}>Some actions may require additional configuration in the provider to be accessible. Choose the actions you need and the guide will be updated.</div>

    <div style={{ display: 'flex', gap: '8px', marginBottom: '12px', flexWrap: 'wrap' }}>
      <input type="text" placeholder="Search actions..." className="guides-scope-selector__input" data-guide-action-search style={{ padding: '8px 12px', borderRadius: '6px', fontSize: '13px', flex: 1, minWidth: '160px' }} />

      <button type="button" className="guides-scope-selector__quick-btn" data-guide-select-all style={{ padding: '6px 10px', borderRadius: '6px', fontSize: '12px', cursor: 'pointer' }}>Select all</button>
      <button type="button" className="guides-scope-selector__quick-btn" data-guide-clear style={{ padding: '6px 10px', borderRadius: '6px', fontSize: '12px', cursor: 'pointer' }}>Clear</button>
    </div>

    <div className="guides-scope-selector__list" style={{ maxHeight: '240px', overflowY: 'auto', borderRadius: '6px', marginBottom: '12px' }}>
      <div className="guides-scope-selector__list-header" style={{ display: 'flex', alignItems: 'center', gap: '10px', padding: '8px 12px', fontSize: '12px', fontWeight: '600', position: 'sticky', top: 0, zIndex: 1 }}>
        <div style={{ width: '16px', flexShrink: 0 }} />

        <div style={{ flex: 1, textAlign: 'left' }}>Action</div>
        <div style={{ minWidth: '120px', marginLeft: 'auto', textAlign: 'right' }}>Scope(s)</div>
      </div>

      <div className="guides-scope-selector__muted" data-guide-loading style={{ padding: '16px', textAlign: 'center', fontSize: '13px' }}>Loading actions...</div>
      <div className="guides-scope-selector__muted" data-guide-no-results hidden style={{ padding: '16px', textAlign: 'center', fontSize: '13px' }}>No actions match your search.</div>
    </div>

    <div className="guides-scope-selector__url-section" style={{ marginTop: '12px', paddingTop: '12px' }}>
      <div className="guides-scope-selector__muted" style={{ fontSize: '12px', fontWeight: '500', marginBottom: '6px' }}>Dynamic Guide URL</div>

      <div style={{ display: 'flex', alignItems: 'center', gap: '8px', flexWrap: 'wrap' }}>
        <input type="text" readOnly className="guides-scope-selector__input" data-guide-url style={{ flex: 1, minWidth: '200px', padding: '8px 10px', borderRadius: '6px', fontSize: '12px', fontFamily: 'monospace' }} />

        <button type="button" className="guides-scope-selector__copy-btn" data-guide-copy-url style={{ width: '120px', padding: '8px 14px', borderRadius: '6px', fontSize: '13px', fontWeight: '500', cursor: 'pointer', whiteSpace: 'nowrap', marginLeft: 'auto' }}>Copy URL</button>
      </div>

      <div style={{ marginTop: '12px' }}>
        <div className="guides-scope-selector__muted" style={{ fontSize: '12px', fontWeight: '500', marginBottom: '6px' }}>Scopes Selected</div>

        <div style={{ display: 'flex', alignItems: 'stretch', gap: '8px', flexWrap: 'wrap' }}>
          <pre className="guides-scope-selector__input" role="textbox" aria-readonly="true" tabIndex={0} data-guide-scopes-output style={{ flex: 1, minWidth: '200px', minHeight: '88px', maxHeight: '120px', overflowY: 'auto', margin: 0, padding: '8px 10px', borderRadius: '6px', fontSize: '12px', fontFamily: 'monospace', whiteSpace: 'pre-wrap' }} />

          <div className="guides-scope-selector__muted" style={{ display: 'flex', flexDirection: 'column', gap: '8px', fontSize: '12px', fontWeight: '500', flexShrink: 0, alignItems: 'flex-start' }}>
            <div style={{ whiteSpace: 'nowrap' }}>Separator</div>

            <select className="guides-scope-selector__input" data-guide-scope-delimiter style={{ width: '100%', padding: '6px 10px', borderRadius: '6px', fontSize: '12px' }}>
              <option value="space">Space</option>
              <option value="comma">Comma</option>
              <option value="semicolon">Semicolon</option>
              <option value="pipe">Pipe</option>
              <option value="newline">Newline</option>
            </select>

            <button type="button" className="guides-scope-selector__copy-btn" data-guide-copy-scopes style={{ width: '120px', padding: '8px 14px', borderRadius: '6px', fontSize: '13px', fontWeight: '500', cursor: 'pointer', whiteSpace: 'nowrap' }}>Copy scopes</button>
          </div>
        </div>
      </div>
    </div>
  </div>
</Panel>

<section data-guide-section data-guide-scopes="">
  <h2>Create a GoCardless access token</h2>

  <p>GoCardless authenticates API requests with a Bearer access token created from the dashboard.</p>

  <Steps>
    <Step title="Sign in to GoCardless">
      <div data-guide-step data-guide-scopes="" data-guide-display-scopes-list="">
        <p>Sign in to the GoCardless dashboard for the environment you are connecting:</p>

        <ul>
          <li><strong>Production</strong> — <a href="https://manage.gocardless.com/sign-in" target="_blank" rel="noopener noreferrer">GoCardless dashboard sign-in</a>; live tokens start with `live_`</li>
          <li><strong>Sandbox</strong> — <a href="https://manage-sandbox.gocardless.com/sign-in" target="_blank" rel="noopener noreferrer">GoCardless sandbox dashboard sign-in</a>; sandbox tokens start with `sandbox_`</li>
          <li>Create the token in the same environment you will select in StackOne Hub — tokens only work in the environment they were created in.</li>
        </ul>

        <img src="https://mintcdn.com/stackone-60/OmKBo4CDQOnMK2re/connectors/gocardless/images/api_key-config-sign-in.png?fit=max&auto=format&n=OmKBo4CDQOnMK2re&q=85&s=d3af23c878c88671f51e8fa6918e7386" alt="GoCardless sign in page with the Email address and Password fields" width="1280" height="800" data-path="connectors/gocardless/images/api_key-config-sign-in.png" />
      </div>
    </Step>

    <Step title="Open 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>. The <strong>Access tokens</strong> section lists your existing tokens.</p>

        <img src="https://mintcdn.com/stackone-60/OmKBo4CDQOnMK2re/connectors/gocardless/images/api_key-config-api-settings.png?fit=max&auto=format&n=OmKBo4CDQOnMK2re&q=85&s=3d4dee96435f43ca53119590e99540c0" alt="The API Settings page with the Access tokens section and the Create dropdown in the top right corner" width="1280" height="800" data-path="connectors/gocardless/images/api_key-config-api-settings.png" />
      </div>
    </Step>

    <Step title="Create an access token">
      <div data-guide-step data-guide-scopes="" data-guide-display-scopes-list="">
        <p>On the <strong>API Settings</strong> page, click the <strong>Create</strong> dropdown in the top right corner, then select <strong>Access token</strong> from the menu.</p>

        <img src="https://mintcdn.com/stackone-60/OmKBo4CDQOnMK2re/connectors/gocardless/images/api_key-config-create-access-token.png?fit=max&auto=format&n=OmKBo4CDQOnMK2re&q=85&s=b2241636ae4bad35f09eea89c2b903b3" alt="The Create dropdown on the API Settings page with the Access token option highlighted" width="1280" height="800" data-path="connectors/gocardless/images/api_key-config-create-access-token.png" />
      </div>
    </Step>

    <Step title="Configure the token">
      <div data-guide-step data-guide-scopes="read_only,read_write" data-guide-display-scopes-list="read_only,read_write">
        <div className="connector-guide-actions-badge" data-guide-actions-badge data-guide-actions-badge-scopes="read_only,read_write" style={{ display: 'block', width: 'fit-content', maxWidth: '100%', padding: '2px 8px', borderRadius: '8px', fontSize: '12px', marginBottom: '8px', marginTop: '-10px', whiteSpace: 'nowrap', overflowX: 'auto', overflowY: 'hidden', msOverflowStyle: 'none', scrollbarWidth: 'none' }}>
          <span>Enables actions: </span><span data-guide-actions-badge-labels>Cancel A Mandate, Cancel A Payment, Cancel An Instalment Schedule, Cancel Billing Request, Cancel Subscription, Collect Bank Account For Billing Request, Collect Customer Details For Billing Request, Confirm Payer Details For Billing Request, Create A Creditor Bank Account, Create A Customer, Create A Customer Bank Account, Create A Mandate, Create A Payment, Create Billing Request, Create Billing Request Flow, Create Instalment Schedule With Dates, Create Instalment Schedule With Schedule, Create Refund, Create Subscription, Disable A Creditor Bank Account, Disable A Customer Bank Account, Fallback Billing Request To Direct Debit, Fulfil Billing Request, Get A Single Creditor, Get A Single Creditor Bank Account, Get A Single Customer, Get A Single Customer Bank Account, Get A Single Instalment Schedule, Get A Single Mandate, Get A Single Payment, Get A Single Payout, Get A Single Tax Rate, Get Billing Request, Get Event, Get Refund, Get Subscription, List Billing Requests, List Creditor Bank Accounts, List Creditors, List Customer Bank Accounts, List Customers, List Events, List Instalment Schedules, List Mandates, List Payments, List Payout Items, List Payouts, List Refunds, List Subscriptions, List Tax Rates, Notify Billing Request Customer, Pause Subscription, Reinstate A Mandate, Remove A Customer, Resume Subscription, Retry A Payment, Run Scenario Simulator, Update A Creditor, Update A Customer, Update A Customer Bank Account, Update A Mandate, Update A Payment, Update A Payout, Update An Instalment Schedule, Update Refund, Update Subscription</span>
        </div>

        <p>In the <strong>Create access token</strong> dialog, provide the token details, then click <strong>Create</strong>:</p>

        <ul>
          <li><strong>Name</strong> — enter a descriptive name for the token (for example, `StackOne Integration`).</li>
          <li><strong>Scope</strong> — select <strong>Read-write access</strong> for full API access (required to create, update, and cancel payments, mandates, subscriptions, and customers), or <strong>Read only access</strong> if you only need read operations.</li>
        </ul>

        <img src="https://mintcdn.com/stackone-60/OmKBo4CDQOnMK2re/connectors/gocardless/images/api_key-config-token-dialog.png?fit=max&auto=format&n=OmKBo4CDQOnMK2re&q=85&s=fcdfed1af7f9604b3221b595b12bf27b" alt="The Create access token dialog with the Name field and the Scope options Read only access and Read-write access" width="1280" height="800" data-path="connectors/gocardless/images/api_key-config-token-dialog.png" />

        <div style={{ marginTop: '8px' }} data-guide-display-scopes>
          <div className="connector-guide-scopes-container">
            <ul className="not-prose" style={{ listStyleType: "'- '", paddingLeft: '1em', margin: 0 }}>
              <li style={{ overflowWrap: 'anywhere', wordBreak: 'break-word' }} data-guide-display-scope="read_only">
                <button type="button" className="connector-guide-scope-copy" aria-label="Copy read_only" title="Copy scope" data-copy="read_only">
                  <span className="connector-guide-scope-copy__label">read\_only</span>
                  <span className="connector-guide-scope-copy__icon" aria-hidden="true">⧉</span>
                </button>
              </li>

              <li style={{ overflowWrap: 'anywhere', wordBreak: 'break-word' }} data-guide-display-scope="read_write">
                <button type="button" className="connector-guide-scope-copy" aria-label="Copy read_write" title="Copy scope" data-copy="read_write">
                  <span className="connector-guide-scope-copy__label">read\_write</span>
                  <span className="connector-guide-scope-copy__icon" aria-hidden="true">⧉</span>
                </button>
              </li>
            </ul>
          </div>
        </div>
      </div>
    </Step>

    <Step title="Copy the access token">
      <div data-guide-step data-guide-scopes="" data-guide-display-scopes-list="">
        <p>An <strong>Access token successfully created</strong> dialog appears with your new token in the <strong>Token</strong> field. The dialog warns: <strong>Your access token can only be viewed once.</strong></p>

        <ul>
          <li>The token cannot be retrieved after this dialog is closed — copy it immediately and store it securely.</li>
          <li>Paste the copied value into the <strong>Access Token</strong> field in StackOne Hub.</li>
          <li>Click <strong>I've copied this access token</strong> to dismiss the dialog.</li>
        </ul>

        <img src="https://mintcdn.com/stackone-60/OmKBo4CDQOnMK2re/connectors/gocardless/images/api_key-config-token-created.png?fit=max&auto=format&n=OmKBo4CDQOnMK2re&q=85&s=7c70581f5ef277f03ba8d1de8844a78c" alt="The Access token successfully created dialog showing the Token field, the view-once warning, and the I've copied this access token button" width="1280" height="800" data-path="connectors/gocardless/images/api_key-config-token-created.png" />
      </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>
