---
updatedAt: 2025-11-15T00:05:14.000Z
agentTools:
  projectIndex: https://developer.bill.com/llms.txt
---

# BILL partner operations

In this section, we walk through the partner-level operations available with the BILL v3 API.

> 👍 Become a BILL partner
>
> If you are interested in becoming a BILL partner, please reach out to your account manager for more information.

## Who is a BILL partner?

As a BILL partner, you can perform partner-level operations, which include creating an organization, and then creating and managing users for that organization.

<Image align="center" alt="BILL partner users vs organization users" border={false} src="https://files.readme.io/98504ec510cf119ab5578724a79ad4c66f0bffc2e84301d875c9c36ae64dc4dc-partner_user_vs_org_user.jpeg" />

In this table, we compare workflows between BILL partners and organization-level users.

<Table align={["left","left","left"]}>
  <thead>
    <tr>
      <th>
        Workflow
      </th>

      <th>
        BILL partner
      </th>

      <th>
        BILL organization-level user
      </th>
    </tr>
  </thead>

  <tbody>
    <tr>
      <td>
        **API login**
      </td>

      <td>
        Sign in with **`POST /v3/partner/login`** to generate a **`sessionId`**. The API request requires three parameters.

        * **`appKey`**
        * **`username`**
        * **`password`**<br />

        See the <Anchor label="POST /v3/partner/login" target="_blank" href="ref:partnerlogin">POST /v3/partner/login</Anchor>  API for more information.
      </td>

      <td>
        Sign in with **`POST /v3/login`** to generate a **`sessionId`**. The API request requires four parameters.

        * **`devKey`**
        * **`username`**
        * **`password`**
        * **`organizationId`**
      </td>
    </tr>

    <tr>
      <td>
        **Available operations**
      </td>

      <td>
        * **Create organizations**: Use **`appKey`** and **`sessionId`** to create a BILL organization. A BILL-generated organization **`id`** is available for the created organization.
        * **Create and manage users**: Use **`appKey`**,**`sessionId`**, and **`organizationId`** to create a user for the organization. A BILL-generated user **`id`** is available for the created user. You can also manage user access for the organization.
        * **Sign in as a created user**: Use **`appKey`**, **`sessionId`**, **`organizationId`**, and **`userId`** to sign in as a user of the BILL organization. After signing in, you can perform organization-level BILL API operations, such as creating a bill or paying a vendor. All organization-level BILL API operations require a **`devKey`** and **`sessionId`**.

        **Note**: When you create an organization and then create a user for that organization, it is important that you add a phone number for the created user (with `POST /v3/partner/risk-verifications/{userId}/phone`), and then initiate risk verification (with `POST /v3/risk-verifications`)
      </td>

      <td>
        Use **`devKey`** and **`sessionId`** to perform organization-level BILL API operations. You cannot perform any partner-level operations with the **`devKey`** and **`sessionId`**.
      </td>
    </tr>
  </tbody>
</Table>

In the next set of sections, we walk through creating organizations and users as BILL partners.

* <Anchor label="Organizations for BILL partners" target="_blank" href="doc:partner-organizations">Organizations for BILL partners</Anchor>
* <Anchor label="Users for BILL partners" target="_blank" href="doc:partner-users">Users for BILL partners</Anchor>

<br />