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.
In this table, we compare workflows between BILL partners and organization-level users.
Workflow
BILL partner
BILL organization-level user
API login
Sign in with POST /v3/partner/login to generate a sessionId. The API request requires three parameters.
Sign in with POST /v3/login to generate a sessionId. The API request requires four parameters.
devKey
username
password
organizationId
Available operations
*Create organizations: UseappKeyandsessionIdto create a BILL organization. A BILL-generated organizationid** is available for the created organization.
*Create and manage users: UseappKey,sessionId, andorganizationIdto create a user for the organization. A BILL-generated userid** is available for the created user. You can also manage user access for the organization.
*Sign in as a created user: UseappKey,sessionId,organizationId, anduserIdto 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 adevKeyandsessionId**.
*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)
Use devKey and sessionId to perform organization-level BILL API operations. You cannot perform any partner-level operations with the devKey and sessionId.
In the next set of sections, we walk through creating organizations and users as BILL partners.