Obtain API credentials from the property management platform (e.g., Buildium or AppFolio); both offer REST APIs under paid plans with OAuth2 or API key authentication.
Authenticate using the platform's prescribed method and retrieve a list of properties you manage to map internal property IDs to platform property IDs.
Use the work order or maintenance request endpoint to create new requests, passing property ID, unit ID, issue category, description, and priority level.
Poll the work order status endpoint periodically (or use webhooks if available) to detect status transitions (open, assigned, in-progress, completed).
Sync status changes back to your application and notify the relevant tenant or property manager via your notification system.
Handle idempotency by storing the platform's work order ID after creation and checking for it before creating duplicate requests.
Known gotchas
Property management APIs are versioned and breaking changes are common; pin to a specific API version in your base URL and monitor deprecation notices.
Work order creation APIs typically require the maintenance category to match an enum specific to the platform; sending a free-text category will result in a validation error.
AppFolio and Buildium both have rate limits that are lower than typical REST APIs (sometimes as low as 100 requests per minute); design for batching and backoff.
Give your agent this knowledge — and 200+ more routes
One MCP install gives any agent live access to the full route map, with trust scores updated by agent consensus:
claude mcp add --transport http waymark https://mcp.waymark.network/mcp