---
agentTools:
  projectIndex: https://developer.bill.com/llms.txt
---

# New v3 API endpoints for BILL partners

We have introduced new capabilities for BILL partners. As a BILL partner, you can now perform partner-level operations, which includes creating an organization, and then creating and managing users for that organization.

## Requirements

Partner-level API operations have two requirements.

* A `sessionId` generated with [API partner login](https://developer.bill.com/v3/reference/partnerlogin)
* An `appKey` header value

## Organizations and Users

We have introduced a set of partner-level API endpoints that can be accessed with a partner account `sessionId`.

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

      <th>
        API endpoint
      </th>
    </tr>
  </thead>

  <tbody>
    <tr>
      <td>
        [API partner login](https://developer.bill.com/v3/reference/partnerlogin) 
      </td>

      <td>
        `POST /v3/partner/login`
      </td>
    </tr>

    <tr>
      <td>
        [Create an organization](https://developer.bill.com/v3/reference/createorganization) 
      </td>

      <td>
        `POST /v3/partner/organizations`
      </td>
    </tr>

    <tr>
      <td>
        [Create a user](https://developer.bill.com/v3/reference/createpartneruser) 
      </td>

      <td>
        `POST /v3/partner/users`
      </td>
    </tr>

    <tr>
      <td>
        [API login as user](https://developer.bill.com/v3/reference/loginasuser)\
        Sign in to a created organization as a created user of that organization
      </td>

      <td>
        `POST /v3/partner/login-as-user`
      </td>
    </tr>

    <tr>
      <td>
        [Get user details](https://developer.bill.com/v3/reference/getpartneruser) 
      </td>

      <td>
        `GET /v3/partner/users/{userId}`
      </td>
    </tr>

    <tr>
      <td>
        [Update a user](https://developer.bill.com/v3/reference/updatepartneruser) 
      </td>

      <td>
        `PATCH /v3/partner/users/{userId}`
      </td>
    </tr>

    <tr>
      <td>
        [Archive a user](https://developer.bill.com/v3/reference/archivepartneruser) 
      </td>

      <td>
        `POST /v3/partner/users/{userId}/archive`
      </td>
    </tr>

    <tr>
      <td>
        [Restore an archived user](https://developer.bill.com/v3/reference/restorepartneruser) 
      </td>

      <td>
        `POST /v3/partner/users/{userId}/restore`
      </td>
    </tr>

    <tr>
      <td>
        [Get list of user roles](https://developer.bill.com/v3/reference/listpartneruserroles) 
      </td>

      <td>
        `GET /v3/partner/roles`
      </td>
    </tr>

    <tr>
      <td>
        [Get user role details](https://developer.bill.com/v3/reference/getpartneruserrole) 
      </td>

      <td>
        `GET /v3/partner/roles/{roleId}`
      </td>
    </tr>
  </tbody>
</Table>

After signing in as a user with `POST /v3/partner/login-as-user`, you can perform organization-level BILL API operations, such as creating a bill or paying a vendor. Note that all organization-level BILL API operations require a `devKey` and `sessionId`.

See [BILL partner operations](https://developer.bill.com/v3/docs/bill-partner-operations) for more information.