Skip to main content

Brex

Manage Brex spend — users, cards, expenses, budgets, payments, and more via OAuth2, a user token, or partner client credentials.

What you can ask​

  • List all expenses over $500 awaiting review and draft a summary for the finance channel.
  • Issue a virtual card with a $2,000 monthly limit for a new contractor.
  • Pull budget burn for the Q3 Offsite budget and flag whether projected spend exceeds the cap.

Set up​

Brex needs an OAuth application from your organization before anyone can connect. An organization admin completes these steps once.

  1. Go to Organization > Connectors and find Brex. Click Enable, and choose which tools to allow.
  2. Create an OAuth application in the Brex developer portal.
  3. Add the Redirect URI shown in the connector settings to the application.
  4. Copy the application's Client ID and Client Secret into the connector, then save it.
  5. Each member connects their own account the first time they use it.

⚠️ Warning: Do not enter your Devs.ai or Brex login email or password in the OAuth application fields.

To use one account for the whole organization, turn on Share one connection with everyone. Every member's agents then act as that account, with exactly the access it has.

OAuth scopes used by these tools (22)

Grant the scopes for the tools you plan to allow.

  • accounts.card.readonly
  • accounts.cash.readonly
  • budgets
  • cards
  • companies.readonly
  • departments
  • expenses.card
  • https://accounting.brexapis.com/card
  • https://accounting.brexapis.com/cash
  • https://onboarding.brexapis.com/referrals
  • incoming_transfers
  • linked_accounts.readonly
  • locations
  • statements.card.readonly
  • statements.cash.readonly
  • titles
  • transactions.card.readonly
  • transactions.cash.readonly
  • transfers
  • travel.trips
  • users
  • vendors

Tools​

Brex offers 73 tools. Admins choose which ones agents can use. See Tool permission groups.

Read (43)​

View and search information without changing it.

ToolWhat it does
get_accounting_recordGet a specific accounting record.
get_budgetGet a specific budget by ID.
get_budget_programGet a specific budget program by ID.
get_cardGet a specific card by ID.
get_cash_accountGet a specific cash account by ID, with balances.
get_companyGet the Brex company the credential belongs to, including its legal name, mailing address, and account type (BREX_CLASSIC or BREX_EMPOWER).
get_current_userGet the current authenticated user's information.
get_departmentGet a specific department by ID.
get_expenseGet a specific expense by ID.
get_locationGet a specific location by ID.
get_primary_cash_accountGet the primary cash account for the company.
get_referralGet an onboarding referral by ID, including its signup URL and status.
get_spend_limitGet a specific spend limit by ID.
get_titleGet a specific title by ID.
get_transferGet a specific transfer by ID.
get_tripGet a specific trip by ID.
get_trip_bookingGet a specific trip booking by ID.
get_userGet a specific user by ID.
get_user_limitGet a user's monthly spend limit.
get_vendorGet a specific vendor by ID.
list_accounting_recordsList accounting records.
list_budget_programsList all budget programs in the company.
list_budgetsList all budgets in the company.
list_card_accountsList all card accounts in the company.
list_card_statementsList statements for the company's card account, newest period first.
list_card_transactionsList card transactions for the company.
list_cardsList Brex cards.
list_cash_accountsList all cash accounts in the company, with balances.
list_cash_statementsList statements for a cash account.
list_cash_transactionsList transactions for a cash account.
list_departmentsList Brex departments.
list_expensesList expenses, filtering server-side by status, payment status, expense type, user, budget, or a purchased/updated/payment-posted date range.
list_linked_accountsList linked bank accounts eligible to fund ACH transfers into Brex.
list_locationsList Brex locations.
list_referralsList all onboarding referrals created by this application.
list_spend_limitsList all spend limits.
list_titlesList Brex job titles.
list_transfersList all transfers.
list_trip_bookingsList all bookings for a trip.
list_tripsList company trips.
list_usersList Brex users.
list_vendorsList all vendors in the company.
validate_credentialValidate Brex credentials.

Write (14)​

Create or send data.

ToolWhat it does
create_accounting_integrationCreate a new accounting system integration (alpha feature - may be restricted).
create_budgetCreate a budget.
create_cardCreate a new card.
create_departmentCreate a new department.
create_incoming_transferPull funds into a Brex account.
create_locationCreate a new location.
create_receipt_matchRegister a receipt so Brex auto-matches it to a card expense by amount and date.
create_receipt_uploadGet a presigned URL to upload a receipt for a specific card expense.
create_referralCreate an onboarding referral (partner API).
create_spend_limitCreate a new spend limit for a budget or user.
create_titleCreate a new job title.
create_transferCreate an outgoing transfer.
create_userCreate a new Brex user.
create_vendorCreate a new vendor.

Delete or overwrite (16)​

Remove or replace existing data.

ToolWhat it does
archive_budgetArchive a budget (mark as inactive).
archive_spend_limitArchive a spend limit (mark as inactive).
delete_vendorDelete a vendor by ID.
disconnect_accounting_integrationDisconnect an accounting system integration (alpha feature - may be restricted).
lock_cardLock a card.
reactivate_accounting_integrationReactivate a disconnected accounting system integration (alpha feature - may be restricted).
report_accounting_export_resultsReport results of an accounting export (success or failure) (alpha feature - may be restricted).
terminate_cardTerminate a card permanently.
unlock_cardUnlock a locked card.
update_budgetUpdate a budget's name, description, or limit.
update_cardUpdate a card's spend controls and metadata.
update_expenseUpdate a card expense's memo.
update_spend_limitUpdate a spend limit's name, description, or base limit amount.
update_userUpdate a user's details (status, manager, department, location, title).
update_user_limitSet a user's monthly spend limit in cents.
update_vendorUpdate a vendor's name, email, phone, or beneficiary name.
⌘J