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

# Justworks OAuth 2.0 connector profile – StackOne setup guide

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

<Warning>Justworks Partner API access is not self-service. You must contact Justworks to register an OAuth application before proceeding.</Warning>

<Panel>
  <div className="not-prose guides-scope-selector" data-guides-scope-selector data-guide-actions-json="[{&#x22;id&#x22;:&#x22;justworks_get_company&#x22;,&#x22;label&#x22;:&#x22;Get Company&#x22;,&#x22;scopes&#x22;:[&#x22;company.basic:read&#x22;]},{&#x22;id&#x22;:&#x22;justworks_get_company_bank_account&#x22;,&#x22;label&#x22;:&#x22;Get Company Bank Account&#x22;,&#x22;scopes&#x22;:[&#x22;company.bank_account:read&#x22;]},{&#x22;id&#x22;:&#x22;justworks_get_company_business_info&#x22;,&#x22;label&#x22;:&#x22;Get Company Business Info&#x22;,&#x22;scopes&#x22;:[&#x22;company.detail:read&#x22;]},{&#x22;id&#x22;:&#x22;justworks_list_company_custom_fields&#x22;,&#x22;label&#x22;:&#x22;List Company Custom Fields&#x22;,&#x22;scopes&#x22;:[&#x22;company.detail:read&#x22;]},{&#x22;id&#x22;:&#x22;justworks_list_company_jurisdictions&#x22;,&#x22;label&#x22;:&#x22;List Company Jurisdictions&#x22;,&#x22;scopes&#x22;:[&#x22;company.detail:read&#x22;,&#x22;member.detail:read&#x22;]},{&#x22;id&#x22;:&#x22;justworks_list_members&#x22;,&#x22;label&#x22;:&#x22;List Members&#x22;,&#x22;scopes&#x22;:[&#x22;member.basic:read&#x22;]},{&#x22;id&#x22;:&#x22;justworks_get_member&#x22;,&#x22;label&#x22;:&#x22;Get Member&#x22;,&#x22;scopes&#x22;:[&#x22;member.basic:read&#x22;]},{&#x22;id&#x22;:&#x22;justworks_list_member_custom_field_values&#x22;,&#x22;label&#x22;:&#x22;List Member Custom Field Values&#x22;,&#x22;scopes&#x22;:[&#x22;member.detail:read&#x22;]},{&#x22;id&#x22;:&#x22;justworks_list_payrolls&#x22;,&#x22;label&#x22;:&#x22;List Payrolls&#x22;,&#x22;scopes&#x22;:[&#x22;payroll:read&#x22;]},{&#x22;id&#x22;:&#x22;justworks_list_payroll_fees&#x22;,&#x22;label&#x22;:&#x22;List Payroll Fees&#x22;,&#x22;scopes&#x22;:[&#x22;payroll:read&#x22;]},{&#x22;id&#x22;:&#x22;justworks_list_payroll_paystubs&#x22;,&#x22;label&#x22;:&#x22;List Payroll Paystubs&#x22;,&#x22;scopes&#x22;:[&#x22;paystub:read&#x22;]},{&#x22;id&#x22;:&#x22;justworks_get_paystub&#x22;,&#x22;label&#x22;:&#x22;Get Paystub&#x22;,&#x22;scopes&#x22;:[&#x22;paystub:read&#x22;]},{&#x22;id&#x22;:&#x22;justworks_list_deduction_types&#x22;,&#x22;label&#x22;:&#x22;List Deduction Types&#x22;,&#x22;scopes&#x22;:[&#x22;deductions:read&#x22;]},{&#x22;id&#x22;:&#x22;justworks_list_deductions&#x22;,&#x22;label&#x22;:&#x22;List Deductions&#x22;,&#x22;scopes&#x22;:[&#x22;deductions:read&#x22;]},{&#x22;id&#x22;:&#x22;justworks_create_deductions&#x22;,&#x22;label&#x22;:&#x22;Create Deductions&#x22;,&#x22;scopes&#x22;:[&#x22;deductions:write&#x22;]},{&#x22;id&#x22;:&#x22;justworks_update_deductions&#x22;,&#x22;label&#x22;:&#x22;Update Deductions&#x22;,&#x22;scopes&#x22;:[&#x22;deductions:write&#x22;]},{&#x22;id&#x22;:&#x22;justworks_cancel_deductions&#x22;,&#x22;label&#x22;:&#x22;Cancel Deductions&#x22;,&#x22;scopes&#x22;:[&#x22;deductions:write&#x22;]},{&#x22;id&#x22;:&#x22;justworks_create_time_off_balances_report&#x22;,&#x22;label&#x22;:&#x22;Create Time Off Balances Report&#x22;,&#x22;scopes&#x22;:[&#x22;time_off:read&#x22;]},{&#x22;id&#x22;:&#x22;justworks_get_time_off_balances_report&#x22;,&#x22;label&#x22;:&#x22;Get Time Off Balances Report&#x22;,&#x22;scopes&#x22;:[&#x22;time_off:read&#x22;]},{&#x22;id&#x22;:&#x22;justworks_list_time_off_policies&#x22;,&#x22;label&#x22;:&#x22;List Time Off Policies&#x22;,&#x22;scopes&#x22;:[&#x22;time_off:read&#x22;]},{&#x22;id&#x22;:&#x22;justworks_list_time_off_requests&#x22;,&#x22;label&#x22;:&#x22;List Time Off Requests&#x22;,&#x22;scopes&#x22;:[&#x22;time_off:read&#x22;]}]">
    <div className="guides-scope-selector__title">Select Actions to adjust the guide</div>
    <div className="guides-scope-selector__muted guides-scope-selector__subtitle">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 className="guides-scope-selector__toolbar">
      <input type="text" placeholder="Search actions..." className="guides-scope-selector__input guides-scope-selector__search" data-guide-action-search />

      <button type="button" className="guides-scope-selector__quick-btn" data-guide-select-all>Select all</button>
      <button type="button" className="guides-scope-selector__quick-btn" data-guide-clear>Clear</button>
    </div>

    <div className="guides-scope-selector__list">
      <div className="guides-scope-selector__list-header">
        <div className="guides-scope-selector__list-header-spacer" />

        <div className="guides-scope-selector__list-header-action">Action</div>
        <div className="guides-scope-selector__list-header-scopes">Scope(s)</div>
      </div>

      <div className="guides-scope-selector__muted guides-scope-selector__status" data-guide-loading>Loading actions...</div>
      <div className="guides-scope-selector__muted guides-scope-selector__status" data-guide-no-results hidden>No actions match your search.</div>
    </div>

    <div className="guides-scope-selector__url-section">
      <div className="guides-scope-selector__muted guides-scope-selector__label">Dynamic Guide URL</div>

      <div className="guides-scope-selector__url-row">
        <input type="text" readOnly className="guides-scope-selector__input guides-scope-selector__url-input" data-guide-url />

        <button type="button" className="guides-scope-selector__copy-btn guides-scope-selector__copy-btn--end" data-guide-copy-url>Copy URL</button>
      </div>

      <div className="guides-scope-selector__scopes-section">
        <div className="guides-scope-selector__muted guides-scope-selector__label">Scopes Selected</div>

        <div className="guides-scope-selector__scopes-row">
          <pre className="guides-scope-selector__input guides-scope-selector__scopes-output" role="textbox" aria-readonly="true" tabIndex={0} data-guide-scopes-output />

          <div className="guides-scope-selector__muted guides-scope-selector__side-controls">
            <div className="guides-scope-selector__side-label">Separator</div>

            <select className="guides-scope-selector__input guides-scope-selector__delimiter" data-guide-scope-delimiter>
              <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>Copy scopes</button>
          </div>
        </div>
      </div>
    </div>
  </div>
</Panel>

<section data-guide-section data-guide-scopes="">
  <h2>Request Partner API access</h2>

  <p>Contact the Justworks Partner API team to register an OAuth application.</p>

  <Steps>
    <Step title="Contact Justworks">
      <div data-guide-step data-guide-scopes="" data-guide-display-scopes-list="">
        <p>Email <a href="mailto:partner-api@justworks.com" target="_blank" rel="noopener noreferrer">[partner-api@justworks.com](mailto:partner-api@justworks.com)</a> to request API access.</p>

        <ul>
          <li>Provide your application name, a brief description of the integration, and the redirect URI below</li>
          <li>Redirect URI: `https://api.stackone.com/connect/oauth2/justworks/callback`</li>
        </ul>
      </div>
    </Step>

    <Step title="Receive credentials">
      <div data-guide-step data-guide-scopes="" data-guide-display-scopes-list="">
        <p>The Justworks team will create your OAuth application and provide credentials.</p>

        <ul>
          <li>You will receive a <strong>Client ID</strong> and <strong>Client Secret</strong> for your application</li>
          <li>Store both values securely for use later</li>
        </ul>
      </div>
    </Step>
  </Steps>
</section>

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

  <p>When requesting API access, specify the OAuth scopes your integration requires. Scopes determine what data your application can access on behalf of authorized customers.</p>

  <Steps>
    <Step title="Select required scopes">
      <div data-guide-step data-guide-scopes="company.detail:read,company.basic:read,company.bank_account:read,member.detail:read,member.basic:read,member.dob:read,member.sex:read,member.employment:read,member.pay:read,member.tax_id:read,payroll:read,paystub:read,deductions:write,deductions:read,time_off:read" data-guide-display-scopes-list="company.detail:read,company.basic:read,company.bank_account:read,member.detail:read,member.basic:read,member.dob:read,member.sex:read,member.employment:read,member.pay:read,member.tax_id:read,payroll:read,paystub:read,deductions:write,deductions:read,time_off:read">
        <div className="connector-guide-actions-badge" data-guide-actions-badge data-guide-actions-badge-scopes="company.detail:read,company.basic:read,company.bank_account:read,member.detail:read,member.basic:read,member.dob:read,member.sex:read,member.employment:read,member.pay:read,member.tax_id:read,payroll:read,paystub:read,deductions:write,deductions:read,time_off:read">
          <span>Enables actions: </span><span data-guide-actions-badge-labels>Cancel Deductions, Create Deductions, Create Time Off Balances Report, Get Company, Get Company Bank Account, Get Company Business Info, Get Member, Get Paystub, Get Time Off Balances Report, List Company Custom Fields, List Company Jurisdictions, List Deduction Types, List Deductions, List Member Custom Field Values, List Members, List Payroll Fees, List Payroll Paystubs, List Payrolls, List Time Off Policies, List Time Off Requests, Update Deductions</span>
        </div>

        <p>Include the following scopes in your Partner API request based on the data your integration needs.</p>

        <div className="connector-guide-display-scopes" data-guide-display-scopes>
          <div className="connector-guide-scopes-container connector-guide-scopes-container--scrollable">
            <ul className="not-prose connector-guide-scopes-list">
              <li data-guide-display-scope="company.detail:read">
                <button type="button" className="connector-guide-scope-copy" aria-label="Copy company.detail:read" title="Copy scope" data-copy="company.detail:read">
                  <span className="connector-guide-scope-copy__label">company.detail:read</span>
                  <span className="connector-guide-scope-copy__icon" aria-hidden="true">⧉</span>
                </button>
              </li>

              <li data-guide-display-scope="company.basic:read">
                <button type="button" className="connector-guide-scope-copy" aria-label="Copy company.basic:read" title="Copy scope" data-copy="company.basic:read">
                  <span className="connector-guide-scope-copy__label">company.basic:read</span>
                  <span className="connector-guide-scope-copy__icon" aria-hidden="true">⧉</span>
                </button>
              </li>

              <li data-guide-display-scope="company.bank_account:read">
                <button type="button" className="connector-guide-scope-copy" aria-label="Copy company.bank_account:read" title="Copy scope" data-copy="company.bank_account:read">
                  <span className="connector-guide-scope-copy__label">company.bank\_account:read</span>
                  <span className="connector-guide-scope-copy__icon" aria-hidden="true">⧉</span>
                </button>
              </li>

              <li data-guide-display-scope="member.detail:read">
                <button type="button" className="connector-guide-scope-copy" aria-label="Copy member.detail:read" title="Copy scope" data-copy="member.detail:read">
                  <span className="connector-guide-scope-copy__label">member.detail:read</span>
                  <span className="connector-guide-scope-copy__icon" aria-hidden="true">⧉</span>
                </button>
              </li>

              <li data-guide-display-scope="member.basic:read">
                <button type="button" className="connector-guide-scope-copy" aria-label="Copy member.basic:read" title="Copy scope" data-copy="member.basic:read">
                  <span className="connector-guide-scope-copy__label">member.basic:read</span>
                  <span className="connector-guide-scope-copy__icon" aria-hidden="true">⧉</span>
                </button>
              </li>

              <li data-guide-display-scope="member.dob:read">
                <button type="button" className="connector-guide-scope-copy" aria-label="Copy member.dob:read" title="Copy scope" data-copy="member.dob:read">
                  <span className="connector-guide-scope-copy__label">member.dob:read</span>
                  <span className="connector-guide-scope-copy__icon" aria-hidden="true">⧉</span>
                </button>
              </li>

              <li data-guide-display-scope="member.sex:read">
                <button type="button" className="connector-guide-scope-copy" aria-label="Copy member.sex:read" title="Copy scope" data-copy="member.sex:read">
                  <span className="connector-guide-scope-copy__label">member.sex:read</span>
                  <span className="connector-guide-scope-copy__icon" aria-hidden="true">⧉</span>
                </button>
              </li>

              <li data-guide-display-scope="member.employment:read">
                <button type="button" className="connector-guide-scope-copy" aria-label="Copy member.employment:read" title="Copy scope" data-copy="member.employment:read">
                  <span className="connector-guide-scope-copy__label">member.employment:read</span>
                  <span className="connector-guide-scope-copy__icon" aria-hidden="true">⧉</span>
                </button>
              </li>

              <li data-guide-display-scope="member.pay:read">
                <button type="button" className="connector-guide-scope-copy" aria-label="Copy member.pay:read" title="Copy scope" data-copy="member.pay:read">
                  <span className="connector-guide-scope-copy__label">member.pay:read</span>
                  <span className="connector-guide-scope-copy__icon" aria-hidden="true">⧉</span>
                </button>
              </li>

              <li data-guide-display-scope="member.tax_id:read">
                <button type="button" className="connector-guide-scope-copy" aria-label="Copy member.tax_id:read" title="Copy scope" data-copy="member.tax_id:read">
                  <span className="connector-guide-scope-copy__label">member.tax\_id:read</span>
                  <span className="connector-guide-scope-copy__icon" aria-hidden="true">⧉</span>
                </button>
              </li>

              <li data-guide-display-scope="payroll:read">
                <button type="button" className="connector-guide-scope-copy" aria-label="Copy payroll:read" title="Copy scope" data-copy="payroll:read">
                  <span className="connector-guide-scope-copy__label">payroll:read</span>
                  <span className="connector-guide-scope-copy__icon" aria-hidden="true">⧉</span>
                </button>
              </li>

              <li data-guide-display-scope="paystub:read">
                <button type="button" className="connector-guide-scope-copy" aria-label="Copy paystub:read" title="Copy scope" data-copy="paystub:read">
                  <span className="connector-guide-scope-copy__label">paystub:read</span>
                  <span className="connector-guide-scope-copy__icon" aria-hidden="true">⧉</span>
                </button>
              </li>

              <li data-guide-display-scope="deductions:write">
                <button type="button" className="connector-guide-scope-copy" aria-label="Copy deductions:write" title="Copy scope" data-copy="deductions:write">
                  <span className="connector-guide-scope-copy__label">deductions:write</span>
                  <span className="connector-guide-scope-copy__icon" aria-hidden="true">⧉</span>
                </button>
              </li>

              <li data-guide-display-scope="deductions:read">
                <button type="button" className="connector-guide-scope-copy" aria-label="Copy deductions:read" title="Copy scope" data-copy="deductions:read">
                  <span className="connector-guide-scope-copy__label">deductions:read</span>
                  <span className="connector-guide-scope-copy__icon" aria-hidden="true">⧉</span>
                </button>
              </li>

              <li data-guide-display-scope="time_off:read">
                <button type="button" className="connector-guide-scope-copy" aria-label="Copy time_off:read" title="Copy scope" data-copy="time_off:read">
                  <span className="connector-guide-scope-copy__label">time\_off:read</span>
                  <span className="connector-guide-scope-copy__icon" aria-hidden="true">⧉</span>
                </button>
              </li>
            </ul>
          </div>
        </div>
      </div>
    </Step>
  </Steps>
</section>

## Creating the StackOne Connector Profile

To create the Connector Profile in StackOne for <strong>Justworks</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>Justworks</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 className="connector-guide-field-list">
          <li><strong>Client ID</strong></li>
          <li><strong>Client 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="/connect/managing-connectors/linking-accounts">Link Accounts</a> for <strong>Justworks</strong>.