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

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

<Warning>A JobDiva administrator or team leader account is required to create the API user. You will also need to contact JobDiva support to obtain your Client ID.</Warning>

<section data-guide-section data-guide-scopes="">
  <h2>Obtain your Client ID</h2>

  <p>The Client ID is a unique numeric identifier assigned to your JobDiva account. It cannot be generated within the platform and must be requested from JobDiva support.</p>

  <Steps>
    <Step title="Contact JobDiva support">
      <div data-guide-step data-guide-scopes="" data-guide-display-scopes-list="">
        <p>Send an email to <a href="mailto:support@jobdiva.com" target="_blank" rel="noopener noreferrer">[support@jobdiva.com](mailto:support@jobdiva.com)</a> requesting your API Client ID.</p>

        <ul>
          <li>Use a subject line such as: <strong>Request for API Client ID for third-party integration</strong></li>
          <li>Include your company name and JobDiva account details in the email.</li>
          <li>JobDiva support will respond with your Client ID, which is a numeric value (e.g. `123456`).</li>
        </ul>
      </div>
    </Step>

    <Step title="Save your Client ID">
      <div data-guide-step data-guide-scopes="" data-guide-display-scopes-list="">
        <p>Once you receive the Client ID from JobDiva support, copy and store it securely. You will need it when connecting your account.</p>

        <ul>
          <li>The Client ID is a number — do not confuse it with your username or password.</li>
          <li>Paste it into the <strong>Client ID</strong> field when prompted.</li>
        </ul>
      </div>
    </Step>
  </Steps>
</section>

<section data-guide-section data-guide-scopes="">
  <h2>Create a dedicated API user</h2>

  <p>JobDiva requires a separate user account specifically for API access. This account is different from your normal login credentials and should be used exclusively for integrations.</p>

  <Steps>
    <Step title="Sign in to JobDiva">
      <div data-guide-step data-guide-scopes="" data-guide-display-scopes-list="">
        <p>Go to <a href="https://login.jobdiva.com" target="_blank" rel="noopener noreferrer">login.jobdiva.com</a> and sign in with your administrator or team leader account.</p>
      </div>
    </Step>

    <Step title="Navigate to My Team settings">
      <div data-guide-step data-guide-scopes="" data-guide-display-scopes-list="">
        <p>Once signed in, navigate to the team management area.</p>

        <ul>
          <li>Click on <strong>Settings</strong> in the main navigation.</li>
          <li>Select <strong>My Team</strong> from the settings menu.</li>
        </ul>
      </div>
    </Step>

    <Step title="Add a new user">
      <div data-guide-step data-guide-scopes="" data-guide-display-scopes-list="">
        <p>Create a new user account that will serve as your dedicated API user.</p>

        <ul>
          <li>Click <strong>Add User</strong> to create a new team member.</li>
          <li>Enter a recognisable name for the API user (e.g. `StackOne API User`).</li>
          <li>Set an email address for the account (this will be the <strong>API Username</strong>).</li>
          <li>Set a secure password (this will be the <strong>API Password</strong>).</li>
          <li>Save the user account.</li>
        </ul>
      </div>
    </Step>
  </Steps>
</section>

<section data-guide-section data-guide-scopes="">
  <h2>Assign API-only permissions</h2>

  <p>The API user must be restricted to API access only. This ensures the account cannot be used to sign in to the JobDiva web interface directly.</p>

  <Steps>
    <Step title="Open user permissions">
      <div data-guide-step data-guide-scopes="" data-guide-display-scopes-list="">
        <p>Locate the newly created API user in <strong>My Team</strong> and open their permissions settings.</p>

        <ul>
          <li>Find the API user in the team member list.</li>
          <li>Click on <strong>Assign User Permissions</strong> (or the permissions/edit option next to the user).</li>
        </ul>
      </div>
    </Step>

    <Step title="Enable API-only access">
      <div data-guide-step data-guide-scopes="" data-guide-display-scopes-list="">
        <p>Configure the user so that they can only access the JobDiva API.</p>

        <ul>
          <li>Select the permission <strong>Only allow access to JobDiva API Calls</strong>.</li>
          <li>Ensure all other user permissions are deselected.</li>
          <li>Save the permission changes.</li>
          <li>Important: If this permission is not set, the API user may not be able to authenticate via the API.</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>Client ID</strong></li>
        <li><strong>API Username</strong></li>
        <li><strong>API Password</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>