FreshBooks logo
    Accounting

    Metro 2 Integration for FreshBooks

    Integrate FreshBooks with BureauRelay to report customer payment history to credit bureaus. Turn your invoicing data into credit-building opportunities for your customers. BureauRelay connects via FreshBooks' REST API with OAuth 2.0 authentication (Bearer tokens with 12-hour lifespan and one-time-use refresh tokens). FreshBooks does not include native Metro 2 reporting. For API support, contact api@freshbooks.com.

    How It Works

    FreshBooks provides client and invoice data through its REST API (OAuth 2.0 with Bearer tokens). BureauRelay maps invoicing data to Metro 2 Base Segment format, calculates payment ratings from due dates vs. payment dates, and submits to Equifax, Experian, and TransUnion.

    FreshBooks logoFreshBooks
    BureauRelayBureauRelay
    Credit Bureaus

    Benefits

    Invoice to Credit Report

    Turn FreshBooks invoices into credit bureau tradelines. Report Net-30, Net-60, and other credit terms.

    Payment Incentive

    Incentivize on-time payment with credit impact. Reduce days sales outstanding and improve cash flow.

    OAuth 2.0 Integration

    Connect via FreshBooks' REST API with OAuth 2.0. Bearer tokens with 12-hour lifespan for secure access.

    Small Business Friendly

    Affordable credit reporting designed for small businesses and service providers who extend credit terms.

    Automated Monthly Reporting

    Set it up once and BureauRelay pulls data automatically for monthly bureau submissions.

    Data Fields That Sync

    BureauRelay maps these fields from FreshBooks to Metro 2 format automatically.

    • Client demographics and contact information
    • Invoice details, terms, and due dates
    • Payment records, amounts, and dates
    • Outstanding balance and aging
    • Account terms (Net-30, Net-60, etc.)
    • Project and service references

    Get Set Up in 4 Steps

    1

    Connect FreshBooks

    Authorize BureauRelay through FreshBooks' OAuth 2.0 flow. Bearer tokens have a 12-hour lifespan with one-time-use refresh tokens.

    2

    Select Clients

    Choose which clients to include in reporting. Configure credit terms, grace periods, and reporting rules per client or globally.

    3

    Configure Reporting Rules

    Set up how invoices map to Metro 2 account types, how payment ratings are calculated, and what triggers delinquency reporting.

    4

    Begin Reporting

    Validate test data and start monthly credit bureau submissions to all three bureaus.

    Frequently Asked Questions

    Is this useful for freelancers?

    If you extend credit terms (Net-30, etc.) to clients, reporting can incentivize timely payment. One-time projects paid upfront may not benefit as much.

    Does FreshBooks have native credit reporting?

    No. FreshBooks does not include built-in Metro 2 file generation or credit bureau submission. BureauRelay provides this capability through the FreshBooks API.

    How does the OAuth token work?

    FreshBooks uses OAuth 2.0 with Bearer tokens that have a 12-hour lifespan. Refresh tokens are one-time-use, meaning each refresh generates a new refresh token. BureauRelay handles this automatically.

    Where can I get API support?

    FreshBooks API support is available at api@freshbooks.com. BureauRelay handles the technical integration, but FreshBooks support can help with account-specific API issues.

    Ready to Connect FreshBooks?

    Start reporting to credit bureaus from FreshBooks today. Our team will help you get set up quickly.