Integrate with a property management API to sync work orders

Steps

1. 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.
2. Authenticate using the platform's prescribed method and retrieve a list of properties you manage to map internal property IDs to platform property IDs.
3. Use the work order or maintenance request endpoint to create new requests, passing property ID, unit ID, issue category, description, and priority level.
4. Poll the work order status endpoint periodically (or use webhooks if available) to detect status transitions (open, assigned, in-progress, completed).
5. Sync status changes back to your application and notify the relevant tenant or property manager via your notification system.
6. Handle idempotency by storing the platform's work order ID after creation and checking for it before creating duplicate requests.