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 Offsitebudget 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.
- Go to Organization > Connectors and find Brex. Click Enable, and choose which tools to allow.
- Create an OAuth application in the Brex developer portal.
- Add the Redirect URI shown in the connector settings to the application.
- Copy the application's Client ID and Client Secret into the connector, then save it.
- 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.readonlyaccounts.cash.readonlybudgetscardscompanies.readonlydepartmentsexpenses.cardhttps://accounting.brexapis.com/cardhttps://accounting.brexapis.com/cashhttps://onboarding.brexapis.com/referralsincoming_transferslinked_accounts.readonlylocationsstatements.card.readonlystatements.cash.readonlytitlestransactions.card.readonlytransactions.cash.readonlytransferstravel.tripsusersvendors
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.
| Tool | What it does |
|---|---|
get_accounting_record | Get a specific accounting record. |
get_budget | Get a specific budget by ID. |
get_budget_program | Get a specific budget program by ID. |
get_card | Get a specific card by ID. |
get_cash_account | Get a specific cash account by ID, with balances. |
get_company | Get the Brex company the credential belongs to, including its legal name, mailing address, and account type (BREX_CLASSIC or BREX_EMPOWER). |
get_current_user | Get the current authenticated user's information. |
get_department | Get a specific department by ID. |
get_expense | Get a specific expense by ID. |
get_location | Get a specific location by ID. |
get_primary_cash_account | Get the primary cash account for the company. |
get_referral | Get an onboarding referral by ID, including its signup URL and status. |
get_spend_limit | Get a specific spend limit by ID. |
get_title | Get a specific title by ID. |
get_transfer | Get a specific transfer by ID. |
get_trip | Get a specific trip by ID. |
get_trip_booking | Get a specific trip booking by ID. |
get_user | Get a specific user by ID. |
get_user_limit | Get a user's monthly spend limit. |
get_vendor | Get a specific vendor by ID. |
list_accounting_records | List accounting records. |
list_budget_programs | List all budget programs in the company. |
list_budgets | List all budgets in the company. |
list_card_accounts | List all card accounts in the company. |
list_card_statements | List statements for the company's card account, newest period first. |
list_card_transactions | List card transactions for the company. |
list_cards | List Brex cards. |
list_cash_accounts | List all cash accounts in the company, with balances. |
list_cash_statements | List statements for a cash account. |
list_cash_transactions | List transactions for a cash account. |
list_departments | List Brex departments. |
list_expenses | List expenses, filtering server-side by status, payment status, expense type, user, budget, or a purchased/updated/payment-posted date range. |
list_linked_accounts | List linked bank accounts eligible to fund ACH transfers into Brex. |
list_locations | List Brex locations. |
list_referrals | List all onboarding referrals created by this application. |
list_spend_limits | List all spend limits. |
list_titles | List Brex job titles. |
list_transfers | List all transfers. |
list_trip_bookings | List all bookings for a trip. |
list_trips | List company trips. |
list_users | List Brex users. |
list_vendors | List all vendors in the company. |
validate_credential | Validate Brex credentials. |
Write (14)
Create or send data.
| Tool | What it does |
|---|---|
create_accounting_integration | Create a new accounting system integration (alpha feature - may be restricted). |
create_budget | Create a budget. |
create_card | Create a new card. |
create_department | Create a new department. |
create_incoming_transfer | Pull funds into a Brex account. |
create_location | Create a new location. |
create_receipt_match | Register a receipt so Brex auto-matches it to a card expense by amount and date. |
create_receipt_upload | Get a presigned URL to upload a receipt for a specific card expense. |
create_referral | Create an onboarding referral (partner API). |
create_spend_limit | Create a new spend limit for a budget or user. |
create_title | Create a new job title. |
create_transfer | Create an outgoing transfer. |
create_user | Create a new Brex user. |
create_vendor | Create a new vendor. |
Delete or overwrite (16)
Remove or replace existing data.
| Tool | What it does |
|---|---|
archive_budget | Archive a budget (mark as inactive). |
archive_spend_limit | Archive a spend limit (mark as inactive). |
delete_vendor | Delete a vendor by ID. |
disconnect_accounting_integration | Disconnect an accounting system integration (alpha feature - may be restricted). |
lock_card | Lock a card. |
reactivate_accounting_integration | Reactivate a disconnected accounting system integration (alpha feature - may be restricted). |
report_accounting_export_results | Report results of an accounting export (success or failure) (alpha feature - may be restricted). |
terminate_card | Terminate a card permanently. |
unlock_card | Unlock a locked card. |
update_budget | Update a budget's name, description, or limit. |
update_card | Update a card's spend controls and metadata. |
update_expense | Update a card expense's memo. |
update_spend_limit | Update a spend limit's name, description, or base limit amount. |
update_user | Update a user's details (status, manager, department, location, title). |
update_user_limit | Set a user's monthly spend limit in cents. |
update_vendor | Update a vendor's name, email, phone, or beneficiary name. |