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

# PayPal OAuth 2.0 (Client Credentials) connector profile – StackOne setup guide

> Set up the OAuth 2.0 (Client Credentials) connector profile for PayPal in StackOne. One-time admin setup required before your users can link PayPal accounts via Hub.

<Warning>You need a PayPal Developer account to create a REST API app. Sandbox and Live environments use separate Client IDs and Secrets — ensure you copy the correct credentials for the environment you are connecting.</Warning>

<section data-guide-section data-guide-scopes="">
  <h2>Prerequisites</h2>

  <p>Verify you have the necessary access before starting setup.</p>

  <ul>
    <li>A PayPal account (Business or Personal) at paypal.com</li>
    <li>A PayPal Developer account at developer.paypal.com (sign in with your PayPal credentials)</li>
    <li>Access to the PayPal Developer Dashboard to create and manage REST API apps</li>
  </ul>
</section>

<section data-guide-section data-guide-scopes="">
  <h2>Create a REST API App</h2>

  <p>Register a new application in the PayPal Developer Dashboard to obtain API credentials.</p>

  <Steps>
    <Step title="Sign in to the PayPal Developer Dashboard">
      <div data-guide-step data-guide-scopes="" data-guide-display-scopes-list="">
        <p>Sign in to the <a href="https://developer.paypal.com/dashboard/" target="_blank" rel="noopener noreferrer">PayPal Developer Dashboard</a> using your PayPal account credentials.</p>
      </div>
    </Step>

    <Step title="Navigate to Apps & Credentials">
      <div data-guide-step data-guide-scopes="" data-guide-display-scopes-list="">
        <p>In the left sidebar, click <strong>Apps & Credentials</strong>. Use the toggle at the top to switch between <strong>Sandbox</strong> and <strong>Live</strong> environments.</p>
      </div>
    </Step>

    <Step title="Create a new app">
      <div data-guide-step data-guide-scopes="" data-guide-display-scopes-list="">
        <p>Click the <strong>Create App</strong> button.</p>

        <ul>
          <li>Enter an <strong>App Name</strong> (e.g., `StackOne Integration`).</li>
          <li>Select <strong>Merchant</strong> as the <strong>App Type</strong>.</li>
          <li>For Sandbox, optionally select a <strong>Sandbox Business Account</strong> to associate with the app.</li>
          <li>Click <strong>Create App</strong> to finish.</li>
        </ul>
      </div>
    </Step>

    <Step title="Copy the Client ID and Secret">
      <div data-guide-step data-guide-scopes="" data-guide-display-scopes-list="">
        <p>After creating the app, the <strong>Client ID</strong> and <strong>Secret</strong> are displayed immediately on the app details page. Copy both values now.</p>

        <ul>
          <li>Copy the <strong>Client ID</strong> — this is a long alphanumeric string (e.g., `AaBbCcDdEeFfGgHhIiJjKkLlMmNnOoPp`).</li>
          <li>Click <strong>Show</strong> next to <strong>Secret</strong>, then copy the <strong>Secret</strong>.</li>
        </ul>
      </div>
    </Step>
  </Steps>
</section>

<section data-guide-section data-guide-scopes="">
  <h2>Configure App Features and Permissions</h2>

  <p>After creating the app, enable the required features to grant API access to the necessary PayPal services.</p>

  <Steps>
    <Step title="Enable required features">
      <div data-guide-step data-guide-scopes="" data-guide-display-scopes-list="">
        <p>In your app details page, scroll to the <strong>Features</strong> section. Under <strong>Payment capabilities</strong>, toggle on the features your integration requires.</p>

        <ul>
          <li><strong>Save payment methods</strong> — use the Vault API to save your customer's payment methods to speed up checkout</li>
          <li><strong>Subscriptions</strong> — set up recurring payments for customers</li>
          <li><strong>Invoicing</strong> — send and manage customer invoices</li>
          <li><strong>Payment links and buttons</strong> — add payment link, payment button, shopping cart button capabilities</li>
          <li><strong>Payouts</strong> — send payments to multiple PayPal accounts at once</li>
        </ul>
      </div>
    </Step>
  </Steps>
</section>

<section data-guide-section data-guide-scopes="">
  <h2>Select the Matching Environment in StackOne</h2>

  <p>When connecting in StackOne, select the environment that matches the credentials you copied.</p>

  <ul>
    <li><strong>Sandbox</strong> — select if you copied Sandbox credentials</li>
    <li><strong>Live</strong> — select <strong>Production</strong> if you copied Live credentials</li>
    <li>Using mismatched credentials and environment will cause authentication failures</li>
  </ul>
</section>

## Creating the StackOne Connector Profile

To create the Connector Profile in StackOne for <strong>PayPal</strong>:

<Steps>
  <Step title="Navigate to Connector Profiles">
    Login to StackOne and navigate to [Connector Profiles](https://app.stackone.com/connector_profiles)
  </Step>

  <Step title="Create New Connector Profile">
    <ul>
      <li>Click <strong>+ Connector Profile</strong></li>
      <li>Search for and select <strong>PayPal</strong></li>
      <li>Select <strong>Type</strong> as <strong>OAuth 2.0 (Client Credentials)</strong></li>

      <li>
        Fill out the fields using details retrieved from your provider:

        <ul style={{ marginLeft: '20px' }}>
          <li><strong>Client ID</strong></li>
          <li><strong>Secret</strong></li>
        </ul>
      </li>

      <li>(Optional) Select <strong>Actions</strong> to be enabled for this Connector Profile</li>
      <li>Click <strong>Create profile</strong></li>
    </ul>
  </Step>
</Steps>

Congratulations! The new Connector Profile will now show up in your project ready to be used. You can now continue to <a href="/guides/accounts-section#linking-accounts">Link Accounts</a> for <strong>PayPal</strong>.