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

# Planday OAuth 2.0 connector profile – StackOne setup guide

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

<Warning>Administrator access to Planday with a Plus, Pro, or Enterprise subscription is required.</Warning>

<section data-guide-section data-guide-scopes="">
  <h2>Creating an API Application</h2>

  <p>To connect Planday with StackOne, you need to create an API application in your Planday portal.</p>

  <Steps>
    <Step title="Access API Settings">
      <div data-guide-step data-guide-scopes="" data-guide-display-scopes-list="">
        <p>Sign in to your Planday portal (e.g., `https://{yourcompany}.planday.com/`) as an Administrator.</p>

        <ul>
          <li>Click <strong>Settings</strong> on the top bar</li>
          <li>In the left sidebar, under <strong>Integrations</strong>, select <strong>API Access</strong></li>
        </ul>
      </div>
    </Step>

    <Step title="Create New Application">
      <div data-guide-step data-guide-scopes="" data-guide-display-scopes-list="">
        <p>Click <strong>Create App</strong> in the top right corner of the page.</p>

        <ul>
          <li>Enter a descriptive name for your application (e.g., "StackOne Integration")</li>
          <li>Select the required <strong>Scopes</strong> to define what data the integration can access</li>
          <li>Add the redirect URI: `https://api.stackone.com/connect/oauth2/planday/callback`</li>
          <li>Click <strong>Save</strong> to create the application</li>
        </ul>
      </div>
    </Step>

    <Step title="Authorize the Application">
      <div data-guide-step data-guide-scopes="" data-guide-display-scopes-list="">
        <p>After creating the app, you need to authorize it to access your Planday data.</p>

        <ul>
          <li>Find your new application in the list</li>
          <li>Click <strong>Authorize</strong></li>
          <li>Review the consent screen showing all requested permissions</li>
          <li>Click <strong>Authorize</strong> to confirm access</li>
        </ul>
      </div>
    </Step>
  </Steps>
</section>

<section data-guide-section data-guide-scopes="">
  <h2>Retrieving Your Credentials</h2>

  <p>After authorization, retrieve the credentials needed to complete the connection.</p>

  <Steps>
    <Step title="Copy the Application ID">
      <div data-guide-step data-guide-scopes="" data-guide-display-scopes-list="">
        <p>On the API Access page, locate your application tile.</p>

        <ul>
          <li>Find the <strong>App Id</strong> column or field on your application tile</li>
          <li>Copy this value - this is your Application ID (Client ID)</li>
          <li>Example format: `f2370889-3ffe-46b6-83e7-1a20f5a20d2f`</li>
        </ul>
      </div>
    </Step>

    <Step title="Copy the Token Secret">
      <div data-guide-step data-guide-scopes="" data-guide-display-scopes-list="">
        <p>The Token Secret is displayed on your application tile after authorization.</p>

        <ul>
          <li>Locate the token value on your application tile</li>
          <li>Copy this value and store it securely for use later</li>
          <li>This token is used as your Token Secret for the OAuth connection</li>
        </ul>
      </div>
    </Step>
  </Steps>
</section>

## Creating the StackOne Connector Profile

To create the Connector Profile in StackOne for <strong>Planday</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>Planday</strong></li>
      <li>Select <strong>Type</strong> as <strong>OAuth 2.0</strong></li>

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

        <ul style={{ marginLeft: '20px' }}>
          <li><strong>Application ID</strong></li>
          <li><strong>Token Secret</strong></li>
          <li><strong>Scopes</strong> (Optional)</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>Planday</strong>.