> ## 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 Sync Token – StackOne Hub

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

<Warning>A sync token cannot do everything a password sign-in can. BILL blocks these on this connection: creating or cancelling payments, sending invoices, reading, creating or deleting vendor bank accounts, and creating bank accounts. You also cannot turn on bill approvals when creating or updating bills. BILL allows bills, bulk bills, bill documents, vendors, customers, invoices and classifications on this connection.</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. The sync token replaces your email and password in StackOne, so SSO users can connect without a password.</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 email and click <strong>Continue</strong>. SSO users are sent to their company login after clicking Continue.</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>Create a sync token</h2>

  <p>The sync token has two parts: the <strong>name</strong> you give it and the <strong>token</strong> value BILL generates when you save it. You need both.</p>

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

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

    <Step title="Create the token">
      <div data-guide-step data-guide-scopes="" data-guide-display-scopes-list="">
        <p>Click <strong>NEW</strong>, enter a name such as `StackOne`, and click <strong>SAVE</strong>. Paste the name into the <strong>Sync Token Name</strong> field in StackOne Hub, then copy the generated token into the <strong>Sync Token</strong> field.</p>

        <ul>
          <li>Keep the token somewhere safe, such as a password manager.</li>
          <li>A sync token is tied to the organization you created it in. To connect a second organization, create a token in that organization and connect it as a separate account.</li>
        </ul>
      </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. It lives on the <strong>Manage Developer Keys</strong> page, in the same Sync & Integrations menu. Generate one if the table 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>
        </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 into the <strong>Developer Key</strong> field in StackOne Hub.</p>

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

<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>Sync Token Name</strong></li>
        <li><strong>Sync Token</strong></li>
        <li><strong>Developer Key</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>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.