Property Management

Metro 2 Integration for AppFolio

Connect to AppFolio Property Manager's REST API via OAuth 2.0 (authorization code grant) through the AppFolio Stack partner portal. Metro2 calls /get_all_tenants for tenant records, /get_occupancy for lease and unit data, and /get_receivable_payments_for_deposits for payment history. Each field is mapped to the Metro 2 Base Segment, validated against CDIA formatting rules, and submitted to Equifax, Experian, and TransUnion. AppFolio already partners with RentPlus by Rent Dynamics for native rent reporting — this integration extends that to a full Metro 2 file covering all three bureaus with your own data furnisher credentials.

How It Works

Metro2 authenticates to AppFolio's REST API via OAuth 2.0 (authorization code grant) through the AppFolio Stack partner portal. It calls /get_all_tenants for tenant records, /get_occupancy for lease and unit data, and /get_receivable_payments_for_deposits for payment history. Each field is mapped to the Metro 2 Base Segment, validated against CDIA rules, and submitted to Equifax, Experian, and TransUnion.

AppFolio

Metro2

Credit Bureaus

Benefits

OAuth 2.0 REST API

AppFolio uses OAuth 2.0 (authorization code grant) for secure API access. REST endpoints return JSON with tenant, occupancy, and payment data — no SOAP or XML parsing required.

Stack Platform Integration

AppFolio's Stack ecosystem provides a partner API portal with dedicated endpoints for tenant data (/get_all_tenants), occupancy (/get_occupancy), and payment records (/get_receivable_payments_for_deposits).

Complements Native RentPlus Reporting

AppFolio partners with RentPlus by Rent Dynamics for native rent reporting. This Metro2 integration extends that to a full Metro 2 file covering all three bureaus under your own data furnisher credentials.

Portfolio-Wide Reporting

Report across all units and properties managed in AppFolio. The API returns data for your entire portfolio in a single OAuth session.

Read/Write API on Max Plan

AppFolio Plus provides read-only API access, while the Max plan unlocks read/write. Metro2 only requires read access — the Plus plan is sufficient for credit bureau reporting.

Tenant Retention Through Credit Building

Offering rent reporting as an amenity reduces turnover and incentivizes on-time payments. AppFolio users can enroll tenants in credit reporting without leaving the platform.

Data Fields That Sync

Metro2 maps these fields from AppFolio to Metro 2 format automatically.

Tenant name and contact info via GET /get_all_tenants endpoint
Tenant SSN — not available via AppFolio API; collected separately via Metro2's encrypted form
Lease dates and terms from tenant occupancy records
Occupancy status and unit association via GET /get_occupancy
Payment amounts, dates, and deposit types via GET /get_receivable_payments_for_deposits
Outstanding balance calculated from payment records vs. scheduled rent
Property and unit identifiers from occupancy data
Account status derived from lease status and payment history

Get Set Up in 5 Steps

Verify AppFolio Plan

AppFolio API access requires the Plus plan (read-only, $0.50/unit/month, $100/month minimum) or Max plan (read/write). Confirm your plan includes Stack API access at appfolio.com/stack.

Authorize via OAuth

In Metro2, go to Integrations > Add > AppFolio. You'll be redirected to AppFolio to authorize Metro2 via OAuth 2.0. Grant read access to tenant, occupancy, and payment data.

Configure Reporting Rules

Set grace periods, select which properties to report, and define late payment thresholds. Review the automatic field mapping from AppFolio API responses to Metro 2 Base Segment fields.

Test with Sample Data

Run a test sync to pull data from AppFolio and generate a sample Metro 2 file. Review Account Status codes, Payment Ratings, and balance calculations.

Enable Production Reporting

Confirm tenant consent is collected, verify your OAuth token is active, and enable automatic monthly submissions to the credit bureaus.

Frequently Asked Questions

Does this work with AppFolio Plus and Max?

Yes. AppFolio Plus provides read-only API access, which is sufficient for Metro2's needs. The Max plan provides read/write access but Metro2 only reads data. Both plans are supported through the same OAuth 2.0 integration.

How does AppFolio API authentication work?

AppFolio uses OAuth 2.0 with the authorization code grant flow. You authorize Metro2 through AppFolio's Stack portal, and Metro2 receives an access token for making API calls. Tokens are refreshed automatically.

Doesn't AppFolio already report rent to credit bureaus?

AppFolio partners with RentPlus by Rent Dynamics for native rent reporting. This Metro2 integration generates a full Metro 2 file for submission to all three bureaus (Equifax, Experian, and TransUnion) under your own data furnisher credentials.

What about partial payments?

Partial payments are tracked via the /get_receivable_payments_for_deposits endpoint. Metro2 calculates the correct delinquency status based on the difference between scheduled rent and actual payments received.

How often does data sync?

Data syncs daily by default via the AppFolio REST API. You can adjust the frequency or trigger manual syncs in your Metro2 integration settings.

What is AppFolio Stack?

AppFolio Stack is AppFolio's partner integration platform. It provides the API portal, OAuth authentication, and access to endpoints for tenant, occupancy, and payment data. Stack Premium costs $0.50/unit/month with a $100/month minimum.

How is the Payment Rating calculated?

Metro2 calculates the Payment Rating (0-6) by comparing scheduled rent due dates against actual payment dates from AppFolio. 0 = current, 1 = 30-59 days past due, 2 = 60-89 days, up to 6 = 180+ days. Grace periods you configure in Metro2 are applied before calculating delinquency.

Related Integrations

Yardi Voyager

Property Management

Pull tenant, lease, and payment data from Yardi Voyager's SOAP/WSDL web services via interface credentials to generate Metro 2 credit reports for all three bureaus.

Buildium

Property Management

Pull tenant, lease, and payment data from Buildium's REST API via API key authentication to generate Metro 2 credit reports for all three bureaus.

Propertyware

Property Management

Pull tenant, lease, and payment data from Propertyware's REST API via API key to generate Metro 2 credit reports for SFR portfolios across all three bureaus.

Ready to Connect AppFolio?

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