Beyond-Bot.ai Logo+bill Logo

Beyond-Bot.ai + bill

Integration with Bill.com API

What You Can Do with this Integration

Automate Data Entry

Automatically sync new contacts or deals from Beyond-Bot.ai to bill.

Enrich Customer Profiles

Use Beyond-Bot.ai to find and add new information to your records in bill.

Trigger Workflows

Start automated workflows in bill based on conversations with your virtual expert.

Available Actions

Here are the specific actions your virtual expert can perform within bill.

Accept Network Invitation

Accept a network invitation that was sent to the organization by a vendor or customer. when the invitation is accepted, the organization is connected with the vendor or customer in the bill network. see [bill network](doc:bill-network) in the guides section for more information, sample requests, and responses.

Add Phone For Mfa Setup

Sets up multi-factor authentication (mfa) for a user account in the bill api. this endpoint allows users to configure their preferred method of receiving authentication tokens, enhancing account security. it should be used when a user wants to enable mfa or update their existing mfa settings. the setup process requires providing a phone number, selecting between voice calls or text messages for token delivery, and specifying if it's a primary or backup device. this endpoint is crucial for implementing a robust security layer but does not handle the actual authentication process or token validation.

Add Phone For Risk Verification

Add a phone number for the currently signed-in user. bill requires the signed-in user to have a linked phone number for initiating risk verification for the organization. you can check whether a phone number has been added for the user with `get /v3/risk-verifications/phone`. after you add a phone number with this endpoint, you can initiate risk verification for the organization with `post /v3/risk-verifications`.

Api Login

Sign in to your bill developer account. in the response, your api session is created and a bill-generated `sessionid` is available. use the `sessionid` in all subsequent api calls to confirm that you are in a signed-in session. to create an mfa-trusted api session, set `remembermeid` and `device` in addition to the required fields. see [mfa setup](ref:setup) for information about the bill mfa process. you can sign out with `post /v3/logout`. if your api session is inactive for 35 minutes, the session expires and you are automatically signed out. see [api partner login](ref:partnerlogin) for information about the additional permissions you get with the api partner login. **note**: this section is about authentication for working with the bill v3 api. see [authentication with spend & expense api token](doc:authentication-with-api-token) for information about authentication for the spend & expense api endpoints.

Api Login As User

The loginasuser endpoint allows partners to authenticate and log in as a specific user within a designated organization in the bill system. this powerful feature enables partners to access and interact with an organization's account on behalf of a particular user, facilitating seamless integration and support. it should be used when a partner needs to perform actions or access information as if they were the specified user within the organization. this endpoint requires careful use and proper authorization, as it effectively allows impersonation of a user. while it supports mfa for enhanced security, partners should ensure they have explicit permission from the organization and user before utilizing this functionality.

Api Logout

Sign out of your bill developer account. in response, the current `sessionid` expires and your api session is terminated. you will be required to sign in again with `/v3/login` before you can make another api call.

Api Partner Login

Authenticates a partner user and initiates a session with the bill api. this endpoint should be used at the beginning of any integration session to obtain necessary authentication tokens or session identifiers. it verifies the partner's credentials and grants access to other api endpoints. the login process is a prerequisite for accessing any protected resources or performing operations within the bill system. note that this endpoint does not provide any financial or account information directly; it only establishes an authenticated session.

Approve Or Deny A Reimbursement

Approve or deny a reimbursement.

Archive A Bank Account

Archive an existing bank account. in the response, the `archived` field is set as `true`. archiving a bank account at bill has a set of requirements. * **bank account status**: the bank account `status` must be set as `verified`. you can verify the bank account with `post /v3/funding-accounts/banks/{bankaccountid}/verify`. * **bank account user status**: the bank account user `verificationstatus` must be set as `verified`. to begin the verification process, nominate a bank account user with `post /v3/funding-accounts/banks/users`.

Archive A Bank Account User

Archive an existing bank account user. in the response, the `archived` field is set as `true` and the bank account user `verificationstatus` is set as `unverified`.

Archive A Bill

Archive an existing bill. in the response, the `archived` field is set as `true`. you can restore an archived bill with `post /v3/bills/{billid}/restore`. there is no change when you archive an archived bill.

Archive A Chart Of Accounts

Archive an existing chart of accounts. in the response, the `archived` field is set as `true`.

Archive A Customer

Archive an existing customer. in the response, the `archived` field is set as `true`. you can restore an archived customer with `post /v3/customers/{customerid}/restore`. there is no change when you archive an archived customer.

Archive A Department

Archive an existing department. in the response, the `archived` field is set as `true`.

Archive A Job

Archive an existing job. in the response, the `archived` field is set as `true`.

Archive A Location

Archive an existing location. in the response, the `archived` field is set as `true`.

Archive An Accounting Class

Archive an existing accounting class. in the response, the `archived` field is set as `true`.

Archive An Employee

Archive an existing employee. in the response, the `archived` field is set as `true`.

Archive An Invoice

Archive an existing invoice. in the response, the `archived` field is set as `true`. you can restore an archived invoice with `post /v3/invoices/{invoiceid}/restore`. there is no change when you archive an archived invoice.

Archive An Item

Archive an existing item. in the response, the `archived` field is set as `true`.

Archive A Recurring Bill

Archive a recurring bill. in the response, the `archived` field is set as `true`. you can restore an archived recurring bill with `post /v3/recurringbills/{recurringbillid}/restore`. there is no change when you archive an archived recurring bill. when a recurring bill is modified, all future bills are automatically changed.

Archive A Vendor

Archive an existing vendor. in the response, the `archived` field is set as `true`. you can restore an archived vendor with `post /v3/vendors/{vendorid}/restore`. there is no change when you archive an archived vendor.

Archive Multiple Accounting Classes

Archive multiple accounting classes with one api request. in the response, the `archived` field for each object is set as `true`.

Archive Multiple Departments

Archive multiple departments with one api request. in the response, the `archived` field is set as `true`.

Archive Multiple Employees

Archive multiple employees with one api request. in the response, the `archived` field for each object is set as `true`.

Archive Multiple Items

Archive multiple items with one api request. in the response, the `archived` field for each object is set as `true`.

Archive Multiple Jobs

Archive multiple jobs with one api request. in the response, the `archived` field for each object is set as `true`.

Archive Multiple Locations

Archive multiple locations with one api request. in the response, the `archived` field for each object is set as `true`.

Archive Mutliple Chart Of Accounts

Archive multiple chart of accounts with one api request. in the response, the `archived` field for each object is set as `true`.

Archive A User

Archive an existing user. in the response, the `archived` field is set as `true`." you can restore an archived user with `post /v3/users/{userid}/restore`. there is no change when you archive an archived user.

Create A User

Create a new user. the currently signed-in user must have the `administrator` user role in the bill organization to perform this operation. see [organizations and users](doc:organizations-users) in the guides section for more information, sample requests, and responses.

Get List Of Users

Get a list of user objects. by default, you get 20 results on one page of results. set `max` in your request to get up to 100 results on one page. see [search operations with lists](doc:search-op-with-lists) in the guides section for filtering, sorting, and pagination examples.

Get User Details

Get details about a existing user.

Get List Of User Roles

Get a list of user role objects. by default, you get 20 results on one page of results. set `max` in your request to get up to 100 results on one page. see [search operations with lists](doc:search-op-with-lists) in the guides section for filtering, sorting, and pagination examples.

Get User Role Details

Get details about an existing user role.

Restore An Archived User

Restore an archived user. in the response, the `archived` field is set as `false`. you can perform any valid bill operation on restored users. there is no change when you restore a restored user.

Cancel A Payment

Cancel an existing payment. you can attempt to cancel a payment with `post /v3/payments/{paymentid}/cancel` based on a set of conditions. see <a href="https://help.bill.com/hc/en-us/articles/115005898063">payment cancelation and void cut-off timing</a> in the bill help center to learn about the bill cancel payment process and timing. if the conditions are not met, you cannot cancel the payment. at that point, you can attempt to void the payment with `post /v3/payments/{paymentid}/void`.

Check App Health

Retrieve app details, such as version and deployment location.

Create A Bank Account

Create a new bank account. the currently signed-in user must have the `administrator` user role in the bill organization to perform this operation. bill sends an email notification for informing you about changes to your funding accounts. **note**: when you create a bank account, bill sends a test ach payment to the bank account to confirm whether the account details are accurate. in the response, three fields are set to their default values. * the bank account `status` is set as `pending`. you can verify the bank account with `post /v3/funding-accounts/banks/{bankaccountid}/verify`. * the `payables` and `receivables` values are set as `false`. to update these values, update the bank account with `patch /v3/funding-accounts/banks/{bankaccountid}`. see [bank account setup (v3 api)](doc:bank-account-setup-v3-api) in the guides section for more information, sample requests, and responses.

Create A Bill

Create a new bill. see [bills](doc:ap-bills) in the guides section for more information, sample requests, and responses.

Create A Budget

Create a new budget for a company.

Create A Bulk Payment

This endpoint allows you to create and process multiple bill payments in a single api call. it streamlines the payment process for businesses by enabling batch processing of payments to one or multiple vendors. the endpoint supports various funding sources, including bank accounts, credit/debit cards, bill balance (wallet), and ap cards. it offers flexibility in payment scheduling, delivery methods, and transaction tracking. use this endpoint when you need to efficiently manage and execute multiple payments simultaneously, reducing the number of individual api calls and simplifying your payment workflows. note that certain parameters may be required based on the chosen funding source, and there are specific rules for vendor and bill identification that must be followed.

Create A Chart Of Accounts

Create a new chart of accounts.

Create A Customer

Create a new customer. see [customers](doc:ar-customers) in the guides section for more information, sample requests, and responses.

Create A Department

Create a new department.

Create A Job

Create a new job.

Create A Location

Create a new location.

Create An Accounting Class

Create a new accounting class.

Create An Employee

Create a new employee.

Create An Image Upload Url For A Reimbursement

Create an image upload url that can be used to upload receipts for reimbursements.

Create An Invoice

Create a new invoice. see [invoices](doc:ar-invoices) in the guides section for more information, sample requests, and responses.

Create An Item

Create a new item.

Create An Organization

Create a new organization. this operation requires partner-level permissions. * a `sessionid` header value generated with [api partner login](ref:partnerlogin) * an `appkey` header value see [organizations for bill partners](doc:partner-organizations) in the guides section for more information, sample requests, and responses.

Create A Payment

Create a payment. see [get list of vendor payment options](ref:listpaymentoptions) to get details about vendor payment options and payment process dates. **note**: creating a payment requires an mfa-trusted api session. see [mfa setup](ref:setup) for information about the bill mfa process. see [payments](doc:ap-payments) in the guides section for more information, sample requests, and responses.

Create A Recurring Bill

Create a recurring bill. see [recurring bills](doc:ap-recurring-bills) in the guides section for more information, sample requests, and responses.

Create A Reimbursement

Create a reimbursement

Create A Vendor

Creates a new vendor in the bill.com system with comprehensive details for invoicing and payment processing. this endpoint allows you to set up a vendor's basic information, address, payment preferences, tax details, and auto-pay settings. it's particularly useful when onboarding new suppliers or updating existing vendor information en masse. the endpoint requires at minimum the vendor's name and address, but allows for extensive customization of payment terms, currencies, and automated payment rules. note that enabling auto-pay features requires additional authentication through mfa. use this endpoint when you need to add new vendors to your bill.com account or update existing vendors with new information.

Create A Vendor Bank Account

Create a vendor bank account for an existing vendor. to update vendor bank account information, you must first delete the existing vendor bank account (with `delete /v3/vendors/{vendorid}/bank-account`), and then create a new vendor bank account (with `post /v3/vendors/{vendorid}/bank-account`) with the updated information. **note**: when you add vendor bank account information, bill requires 2 business days to complete a one-time verification of the bank account. payments sent to the vendor are processed after the one-time verification is complete. see [get list of vendor payment options](ref:listpaymentoptions) to get details about vendor payment options and payment process dates.

Create A Vendor Card

Create a new vendor card.

Create Custom Field

Create a new custom field.

Create Custom Field Values

Create new custom field values.

Delete A Budget

Delete an existing budget.

Delete A Card

Delete an existing card.

Delete A Custom Field

Delete a custom field.

Delete A Member From A Budget

Delete a member from a budget

Delete A Reimbursement

Delete a specified reimbursement.

Delete A User

Delete an existing user.

Delete A Vendor Bank Account

Delete the existing vendor bank account for a vendor. to update vendor bank account information, you must first delete the existing vendor bank account (with `delete /v3/vendors/{vendorid}/bank-account`), and then create a new vendor bank account (with `post /v3/vendors/{vendorid}/bank-account`) with the updated information.

Delete Customer Connection

Delete an existing network connection with a customer. in addition, use this endpoint to cancel a pending customer connection invite. you can send a new connection invitation after an existing connection or invitation is canceled. **note**: if the invited customer does not respond to an invitation for 60 days, the invitation expires. see [bill network](doc:bill-network) in the guides section for more information, sample requests, and responses.

Delete Custom Field Values

Delete custom fields. values cannot be assigned to current or future transactions. the values will remain assigned to past transactions.

Delete Vendor Connection

Delete an existing network connection with a vendor. in addition, use this endpoint to cancel a pending vendor connection invite. you can send a new connection invitation after an existing connection or invitation is canceled. **note**: if the invited vendor does not respond to an invitation for 60 days, the invitation expires. see [bill network](doc:bill-network) in the guides section for more information, sample requests, and responses.

Generate Mfa Challenge

Generates a multi-factor authentication (mfa) challenge for enhanced security in the bill api. this endpoint initiates the mfa process by creating a challenge that the user must respond to with their authentication token. it provides the option to use either the primary or a backup mfa device for generating the challenge. this tool should be used when implementing mfa flows in your application, particularly before sensitive operations like accessing billing information or making payments. the generated challenge is typically time-sensitive and should be responded to promptly for successful authentication.

Get Accounting Class Details

Get details about an existing accounting class.

Get Api Session Details

Get details about your current api session. this includes information about the current organization id, user id, and mfa status of the organization.

Get A Single Member For A Budget

Get a single member for a budget

Get Attachment Details

Get details about an attachment. from the response, use `downloadlink` in a get request to download the attachment. ``` curl '{downloadlink}&sessionid={session id}' --output {attachment name} ```

Get Audit Trail Details For A Vendor

Get audit trail details about changes made to a vendor object. the audit trail lists records for each create and edit operation. see [getting audit trail details](doc:getting-audit-trail-details) in the guides section for more information, sample requests, and responses.

Get Bank Account Details

Get details about an existing bank account.

Get Bill Details

Get details about an existing bill.

Get Budget Details

Get details about an existing budget.

Get Card Account Details

Get details about an existing card account.

Get Card Details

Get details about an existing card.

Get Card Funding Purpose

Get a list of card funding purpose values based on the vendor and card brand. when you create a payment (`post /v3/payments` or `post /v3/payments/bulk`) with a `card account` funding account `type`, bill requires a vendor industry value for compliance. when bill cannot identify the vendor industry, the `cardfundingpurpose` field must be set in your payment request. use this endpoint to get the list of card funding purpose values you can set. if you get an empty 200 response, bill has information about the vendor industry and setting the `cardfundingpurpose` field is not required in your payment request.

Get Chart Of Accounts Details

Get details about an existing chart of accounts.

Get Check Image Data

Get images of an existing check sent to a vendor. from the response, use `downloadlink` in a get request to download the front and back images of the check. ``` curl '{downloadlink}&sessionid={session id}' --output {check name} ```

Get Current User Details

Get details about the current user.

Get Customer Details

Get details about an existing customer.

Get Customer Invitation Status

Get the status of an existing invitation sent with `post /v3/network/invitation/customer/{customerid}`. when the customer accepts the invitation, your organization is connected with the customer. **note**: if the invited customer does not respond to an invitation for 60 days, the invitation expires. see [bill network](doc:bill-network) in the guides section for more information, sample requests, and responses.

Get Custom Field Details

Get details about a custom field.

Get Custom Field Value

Get details about a custom fields values.

Get Department Details

Get details about an existing department.

Get Document Details

Get details about a document associated with a bill. from the response, use `downloadlink` in a get request to download the document. ``` curl '{downloadlink}&sessionid={session id}' --output {document name} ```

Get Document Upload Status

Get status of a document upload. use this endpoint to identify when a document upload is complete. * at the start of the document upload process (`in progress`), bill generates an `uploadid` for the document. the value begins with `0du`. * when the document upload is complete (`uploaded`), bill generates a `documentid` for the document. the value begins with `00h`.

Get Employee Details

Get details about an existing employee.

Get Funding Account Permissions

Get the funding account permissions available for the current organization and current organization user.

Get International Payments Configuration

Get international payments (not usd) configuration that is required for compliance with international payment rules of a vendor country and vendor bank account. this information is based on vendor country, bill currency, and vendor account type. use this endpoint for getting information before creating an international vendor. in the response, the required `paymentpurpose` and `regulatoryfields` information is retrieved for the vendor. **note**: if you are adding `paymentpurpose` and `regulatoryfields` information after creating an international vendor, use `get /v3/vendors/{vendorid}/configuration` to get the required configuration for your created vendor. see [creating an international vendor](doc:creating-an-international-vendor) for more information on how to set `paymentpurpose` and `regulatoryfields`.

Get Invoice Details

Get details about an existing invoice.

Get Item Details

Get details about an existing item.

Get Job Details

Get details about an existing job.

Get List Of Accounting Classes

Get a list of accounting class objects. by default, you get 20 results on one page of results. set `max` in your request to get up to 100 results on one page. see [search operations with lists](doc:search-op-with-lists) in the guides section for filtering, sorting, and pagination examples.