> ## 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 Bill.com with Session Login – StackOne Hub

> Link a Bill.com account in the StackOne Hub using Session Login. End-user guide to authorize the integration and start using Bill.com actions.

<Warning>Creating payments and creating an organization funding account (bank account) require an MFA-trusted API session. This connection cannot establish one, because BILL creates MFA trust only when an MFA ID is supplied at sign-in and this connection does not collect one — enabling MFA in the BILL web app does not change that. Everything else is unaffected, including adding and removing vendor payout bank accounts, which have been verified to work without MFA trust. MFA is enforced in production only.</Warning>

<section data-guide-section data-guide-scopes="">
  <h2>Sign in to BILL</h2>

  <p>BILL runs production and sandbox on completely separate hosts, each with its own credentials. Sign in to the environment you are connecting, and generate the developer key there — a key from one environment will not work in the other.</p>

  <Steps>
    <Step title="Sign in to the BILL web app">
      <div data-guide-step data-guide-scopes="" data-guide-display-scopes-list="">
        <p>Open the sign-in page for your environment, enter your address under <strong>Email</strong>, click <strong>Continue</strong>, and complete your password and any verification prompts.</p>

        <ul>
          <li><strong>Production</strong> — <a href="https://login.us.bill.com/neo/login" target="_blank" rel="noopener noreferrer">BILL production sign-in</a></li>
          <li><strong>Sandbox</strong> — <a href="https://login.stage.us.bill.com/neo/login" target="_blank" rel="noopener noreferrer">BILL sandbox sign-in</a></li>
          <li>Select the matching environment (Production or Sandbox) when you connect the account in StackOne Hub.</li>
        </ul>

        <img src="https://mintcdn.com/stackone-60/qh74yE-DdZDhCo-d/connectors/bill/images/custom-config-sign-in.png?fit=max&auto=format&n=qh74yE-DdZDhCo-d&q=85&s=53bf20d7c1ab47324666bbadd872e759" alt="BILL Sign in page with the Email field and Continue button highlighted" width="1280" height="800" data-path="connectors/bill/images/custom-config-sign-in.png" />
      </div>
    </Step>
  </Steps>
</section>

<section data-guide-section data-guide-scopes="">
  <h2>Open Manage Developer Keys</h2>

  <p>The <strong>Developer Key</strong> and the <strong>Organization ID</strong> both live on one page in the BILL app.</p>

  <Steps>
    <Step title="Open Settings">
      <div data-guide-step data-guide-scopes="" data-guide-display-scopes-list="">
        <p>In the left navigation, click <strong>Settings</strong>.</p>

        <img src="https://mintcdn.com/stackone-60/qh74yE-DdZDhCo-d/connectors/bill/images/custom-config-settings.png?fit=max&auto=format&n=qh74yE-DdZDhCo-d&q=85&s=255b43e9c8de8832ad6222f0448f1cf5" alt="BILL left navigation with Settings highlighted" width="1280" height="800" data-path="connectors/bill/images/custom-config-settings.png" />
      </div>
    </Step>

    <Step title="Open Manage Developer Keys">
      <div data-guide-step data-guide-scopes="" data-guide-display-scopes-list="">
        <p>In the settings navigation, expand <strong>Sync & Integrations</strong> and click <strong>Manage Developer Keys</strong>.</p>

        <ul>
          <li>Direct link: `/neo/settings/sync-and-integrations/manage-developer-keys`</li>
        </ul>

        <img src="https://mintcdn.com/stackone-60/qh74yE-DdZDhCo-d/connectors/bill/images/custom-config-manage-developer-keys-menu.png?fit=max&auto=format&n=qh74yE-DdZDhCo-d&q=85&s=1de53da3916bb4744472b2c7eb3d7600" alt="Expanded Sync and Integrations section showing App Center, Manage Developer Keys and Tokens" width="1280" height="800" data-path="connectors/bill/images/custom-config-manage-developer-keys-menu.png" />
      </div>
    </Step>
  </Steps>
</section>

<section data-guide-section data-guide-scopes="">
  <h2>Generate and copy the Developer Key</h2>

  <p>The <strong>Developer Key</strong> identifies your integration to BILL. Generate one if the table on this page is empty.</p>

  <Steps>
    <Step title="Generate a developer key">
      <div data-guide-step data-guide-scopes="" data-guide-display-scopes-list="">
        <p>On the <strong>Manage Developer Keys</strong> page, click <strong>Generate developer key</strong>.</p>

        <img src="https://mintcdn.com/stackone-60/qh74yE-DdZDhCo-d/connectors/bill/images/custom-config-generate-developer-key.png?fit=max&auto=format&n=qh74yE-DdZDhCo-d&q=85&s=4666f62543a5930cb05f3573e8a98b6b" alt="Manage Developer Keys page with the Generate developer key button highlighted" width="1280" height="800" data-path="connectors/bill/images/custom-config-generate-developer-key.png" />
      </div>
    </Step>

    <Step title="Generate the key">
      <div data-guide-step data-guide-scopes="" data-guide-display-scopes-list="">
        <p>Tick <strong>I agree to the BILL developer terms of service.</strong>, then click <strong>Generate key</strong>.</p>

        <ul>
          <li>It takes up to a minute for BILL to generate the key — click <strong>Reload page</strong> after a few moments to see it.</li>
          <li>The new key appears in the table as <strong>Placeholder Name</strong> with <strong>Status</strong> <strong>Ready</strong>. Click <strong>Rename</strong> to give it a recognisable name.</li>
        </ul>

        <img src="https://mintcdn.com/stackone-60/qh74yE-DdZDhCo-d/connectors/bill/images/custom-config-terms-dialog.png?fit=max&auto=format&n=qh74yE-DdZDhCo-d&q=85&s=8ededc1ed29a0540ef87248aa5d499b2" alt="Generate developer key dialog with the terms of service checkbox and Generate key button highlighted" width="1280" height="800" data-path="connectors/bill/images/custom-config-terms-dialog.png" />
      </div>
    </Step>

    <Step title="Copy the Developer Key">
      <div data-guide-step data-guide-scopes="" data-guide-display-scopes-list="">
        <p>In the <strong>Developer key</strong> column, click the eye icon (<strong>Show developer key</strong>) to reveal the value, then copy it. Paste it into the <strong>Developer Key</strong> field in StackOne Hub.</p>

        <ul>
          <li>Keep the key somewhere safe, such as a password manager.</li>
        </ul>

        <img src="https://mintcdn.com/stackone-60/qh74yE-DdZDhCo-d/connectors/bill/images/custom-config-copy-developer-key.png?fit=max&auto=format&n=qh74yE-DdZDhCo-d&q=85&s=09c3346335cb051a574f85d69dd697ed" alt="Developer keys table with the masked key value, its reveal control and the Rename button highlighted" width="1280" height="800" data-path="connectors/bill/images/custom-config-copy-developer-key.png" />
      </div>
    </Step>
  </Steps>
</section>

<section data-guide-section data-guide-scopes="">
  <h2>Copy the Organization ID</h2>

  <p>The <strong>Organization ID</strong> tells BILL which organization to sign in to. It is on the same page — no need to go anywhere else.</p>

  <Steps>
    <Step title="Copy the Organization ID">
      <div data-guide-step data-guide-scopes="" data-guide-display-scopes-list="">
        <p>Scroll to the bottom of the <strong>Manage Developer Keys</strong> page. The value after <strong>Organization ID:</strong> is your organization identifier — copy it and paste it into the <strong>Organization ID</strong> field in StackOne Hub.</p>

        <ul>
          <li>Format: `008` followed by 17 alphanumeric characters</li>
          <li>Example: `00801ABCDEFGHIJKLMNO`</li>
        </ul>

        <img src="https://mintcdn.com/stackone-60/qh74yE-DdZDhCo-d/connectors/bill/images/custom-config-organization-id.png?fit=max&auto=format&n=qh74yE-DdZDhCo-d&q=85&s=f1ce6d1517ffe1dc9f594ad0a36afc01" alt="Bottom of the Manage Developer Keys page with the Organization ID line highlighted" width="1280" height="800" data-path="connectors/bill/images/custom-config-organization-id.png" />
      </div>
    </Step>
  </Steps>
</section>

<section data-guide-section data-guide-scopes="">
  <h2>Enter your Email and Password</h2>

  <p>The last two values are simply your BILL sign-in credentials.</p>

  <Steps>
    <Step title="Enter your BILL sign-in credentials">
      <div data-guide-step data-guide-scopes="" data-guide-display-scopes-list="">
        <p>In StackOne Hub, enter the address you sign in with under <strong>Email</strong> and its password under <strong>Password</strong> — the same pair you used in the first step. StackOne exchanges them for a session ID and never re-shares them.</p>

        <ul>
          <li>Actions run with the permissions of this BILL user, so make sure it can see the bills, vendors, invoices, and customers you want to sync.</li>
          <li>An API session expires after 35 minutes of inactivity. StackOne signs back in automatically, so no action is needed from you.</li>
          <li>Need help with developer keys? See the <a href="https://developer.bill.com/docs" target="_blank" rel="noopener noreferrer">BILL developer documentation</a>.</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="/connect/managing-connectors/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>Developer Key</strong></li>
        <li><strong>Email</strong></li>
        <li><strong>Password</strong></li>
        <li><strong>Organization ID</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="/gateway/concepts/linked-accounts">Accounts</a> page.</p>
</div>