OAuth API scope capabilities

OAuth client credentials support two access scopes: Full access and Accounting data access. The scope you select when creating a developer app defines which BILL v3 API operations your application can perform.

Grants complete API permissions, including payment creation and funding account updates. This scope requires MFA with the real phone number you entered during BILL sign-up.

Note: Select Full access only if your application requires operations that Accounting data access does not allow. You cannot change an app's scope after creation. To use a different scope, create a new developer app.

OAuth availability
OAuth client credentials are not supported for Account Console, BILL partners, BILL app partner integrations, or webhooks. Continue using your existing authentication methods for these specific integrations.

Review OAuth client credential permissions

When you sign in with OAuth client credentials, you have access to specific BILL API services.

📚Full access permissions

With Full access, you can perform every operation in this table.

BILL operation	Access available
API login and sessions	Log in, retrieve API session details, and sign out
Bills, recurring bills, and vendor credits	Retrieve, create (single or multiple), update, replace, archive, and restore bills Perform all recurring bill and vendor credit operations Record AP payments
Bill approvals	Retrieve bills pending approval Approve or deny bills Retrieve, create, update, and delete bill approval policies
AP payments	Retrieve payments, payment details, vendor payment options, exchange rates, and check images Create payments, including bulk and mass payments Retrieve mass payment status Cancel or void payments
Vendors	Retrieve, create (single or multiple), update, archive, and restore vendors Retrieve vendor configuration and international payments configuration Create, retrieve, and delete vendor bank accounts
Customers	Retrieve, create, update, archive, and restore customers Perform all customer contact and customer bank account operations Set charge customer authorization
Invoices, recurring invoices, and credit memos	Retrieve, create, update, replace, archive, and restore invoices Send invoices Perform all recurring invoice and credit memo operations Record AR payments and get invoice payment links
Received payments	Retrieve received payments Charge a customer
Classifications, attachments, documents, exports, and audit trail	Perform all classification, attachment, document, export, and audit trail operations
Funding accounts	Retrieve bank accounts, bank account users, AP Cards, card accounts, card account users, card funding purposes, and funding account permissions Create, update, archive, and verify bank accounts Nominate and archive bank account users
BILL Network	Search the BILL Network, send and accept connection requests, and check request status Delete existing connections Invite a vendor who is not in the BILL Network
Spend & Expense budgets and users	Create, retrieve, update, and delete budgets Assign users to budgets, and retrieve, update, and delete budget members Create, retrieve, update, and delete users
Spend & Expense cards	Create, retrieve, update, delete, freeze, and unfreeze cards Get the token to view the card number and CVV
Spend & Expense transactions and custom fields	Retrieve and update transactions, and accept or reject transactions Generate receipt upload URLs, and add and delete transaction receipts Retrieve and update transaction custom fields, and retrieve their values Create, retrieve, update, and delete custom fields Add, retrieve, and delete custom field values
Spend & Expense reimbursements	Create, retrieve, update, and delete reimbursements Approve or deny reimbursements Create reimbursement upload URLs, and add and delete reimbursement receipts

📗Accounting data access permissions

The following table details the API operations allowed and blocked when using the Accounting data access scope:

BILL operation	Access available	Access not available
API login and sessions	Get API session details and sign out	Log in
Bills, recurring bills, and vendor credits	• Retrieve, create (single or multiple), update, replace, and restore bills • Perform all recurring bill and vendor credit operations • Record AP payments	Archive bills
Bill approvals	Retrieve bills pending approval	Approve or deny bills Retrieve, create, update, and delete bill approval policies
AP payments	Retrieve payments, payment details, vendor payment options, exchange rates, and check images	Create payments, including bulk and mass payments Retrieve mass payment status Cancel or void payments
Vendors	• Retrieve, create (single or multiple), update, archive, and restore vendors • Retrieve vendor configuration and international payments configuration	Create, retrieve, and delete vendor bank accounts
Customers	• Retrieve, create, update, archive, and restore customers • Perform all customer contact and customer bank account operations	Set charge customer authorization
Invoices, recurring invoices, and credit memos	• Retrieve, create, update, replace, and restore invoices • Perform all recurring invoice and credit memo operations • Record AR payments and get invoice payment links	Archive invoices Send invoices
Received payments	Retrieve received payments	Charge a customer
Classifications, attachments, documents, exports, and audit trail	Perform all classification, attachment, document, export, and audit trail operations
Funding accounts	Retrieve bank accounts, bank account users, AP Cards, card accounts, card funding purposes, and funding account permissions	Create, update, archive, and verify bank accounts Nominate and archive bank account users Retrieve card account users
BILL Network	Search the BILL Network, send and accept connection requests, and check request status	Delete existing connections Invite a vendor who is not in the BILL Network
Spend & Expense budgets and users	Retrieve budgets, budget details, and the current user	Create, update, and delete budgets Assign users to budgets, and retrieve, update, and delete budget members Create, update, and delete users Retrieve the list of users and user details
Spend & Expense cards	Retrieve cards	Create, update, delete, freeze, and unfreeze cards Retrieve card details Get the token to view the card number and CVV
Spend & Expense transactions and custom fields	• Retrieve transactions, generate receipt upload URLs, and update transaction custom fields • Create custom fields, retrieve custom fields, and add custom field values	Retrieve and update transaction details, and accept or reject transactions Retrieve transaction custom fields and their values Add and delete transaction receipts Retrieve, update, and delete custom field details and values
Spend & Expense reimbursements	Retrieve reimbursements	Create, update, delete, approve, and deny reimbursements Retrieve reimbursement details Create reimbursement upload URLs Add and delete reimbursement receipts