Sign in

v1

latestOpenAPI 3.0.02026-08-0661948.3 KB
Accounting Integrations

Create accounting integration

Create a new accounting integration. The behavior depends on the existing active integration:

  • If no active integration exists: Creates and returns new integration
  • If active integration exists with same vendor and vendor_account_id: Returns the existing active integration
  • If active integration exists with same vendor but different vendor_account_id: Returns 409 error
  • If active integration exists with different vendor: Returns 409 error

This ensures only one active integration exists per account.

post/v3/accounting/integration

Request body

vendorstring required

The accounting vendor/system. ERP partners must request Brex to create a vendor ID for them to use this field.

vendor_account_idstring required

The vendor account ID to tie this integration to

Example request

{
  "vendor": "ERP_A",
  "vendor_account_id": "vendor_account_id"
}

Response

Integration created successfully

integration_idstring required

Unique identifier for the integration

vendorstring required

The accounting vendor/system. ERP partners must request Brex to create a vendor ID for them to use this field.

vendor_account_idstring required

The vendor account ID this integration is tied to

status'ACTIVE' | 'DISABLED' required

Current status of the integration

created_atstring date-time required

Timestamp when the integration was created

Example response

{
  "integration_id": "int_abc123",
  "vendor_account_id": "customer_account_id",
  "status": "ACTIVE",
  "created_at": "2025-08-15T10:00:00Z"
}