@this-npm-test-org/connection-appfolio
v0.1.3
Published
Property management: units, tenants, leases, maintenance requests, accounting, and owner statements.
Readme
AppFolio Connection
Connects your agent to AppFolio Property Manager for property management operations. Read units, tenants, leases, maintenance requests, owner data, and financial transactions. Write operations (update maintenance status, post charges) require confirmation.
Authentication
API key.
api_key— AppFolio API key from Settings > APIdatabase_name— Your AppFolio database name
Endpoints
Units
GET /api/v1/units— List units with vacancy status, rent amount, propertyGET /api/v1/units/{id}— Get unit detail with lease history and current tenant
Tenants
GET /api/v1/tenants— Search tenants by name, property, statusGET /api/v1/tenants/{id}— Get tenant detail with lease, balance, payment history
Leases
GET /api/v1/leases— List leases with expiration date, rent amount, statusGET /api/v1/leases/{id}— Get lease detail with terms and charges
Maintenance Requests
GET /api/v1/maintenance_requests— List requests with status, priority, propertyGET /api/v1/maintenance_requests/{id}— Get request detail with notes and vendorPATCH /api/v1/maintenance_requests/{id}— Update status or assign vendor (confirmation)
Owners
GET /api/v1/owners— List property owners with portfolio summaryGET /api/v1/owners/{id}/statement— Get owner statement for date range
Financials
GET /api/v1/reports/rent_roll— Current rent roll with vacancy and delinquencyGET /api/v1/reports/income_statement— Income statement by property or portfolio
Rules
- Rate limit: 60 requests/minute
- Maintenance status updates require confirmation
- Financial data is read-only — no posting transactions via API
- The agent includes property name and address in all responses for context
- Bulk operations (>5 records) require itemized confirmation
