Overview
The Buildium API integration connects your Buildium account directly to Aptly so your property, unit, lease, tenant, owner, vendor, and work order data stays in sync between both systems. Instead of duplicating data entry, you manage your day-to-day workflows in Aptly — leasing, renewals, maintenance dispatch, owner communication — while Buildium remains your accounting and source-of-record system for financials.
This article explains exactly which fields sync, in which direction, and which fields are read-only in Aptly. Use it as your reference when designing boards, building automations, or troubleshooting why a field isn't updating the way you expect.
Why this matters
Knowing the sync direction of each field up front saves hours of "why isn't this updating?" debugging later.
How the Sync Works
Sync directions explained
Every field in the Buildium integration falls into one of three categories:
- Read/Write — The field syncs both ways. You can edit it in Aptly, and the change pushes to Buildium. You can edit it in Buildium, and the change pulls into Aptly.
- Read only — The field pulls from Buildium into Aptly, but cannot be edited from Aptly. To change the value, you must update it in Buildium.
- Write only — The field can be sent from Aptly to Buildium, but Aptly does not pull updates back. This is rare and used mostly for sensitive fields like date of birth.
Boards involved
The Buildium sync populates the following core boards in Aptly:
- Properties (Buildings in Buildium)
- Units
- Leases & Tenants
- Rental Owners
- Vendors
- Work Orders
Each board has its own card type with fields that map to Buildium entities. When data changes in Buildium, the corresponding card in Aptly updates automatically — typically within a few minutes.
Linked relationships
Buildium maintains relationships between entities (a unit belongs to a property, a lease belongs to a unit, a work order is tied to a property or unit). Aptly preserves these as location links and unit links on the relevant cards. These links are read-only because they reflect Buildium's record structure — if you need to move a lease to a different unit, you do that in Buildium and Aptly will follow.
What Syncs by Board
Properties (Buildings)
Field | Sync Direction |
Name | Read/Write |
Address | Read/Write |
Structure Description | Read/Write |
Year Built | Read/Write |
Operating Bank Account | Read/Write |
Rental Sub Type | Read/Write |
Reserve | Read/Write |
Is Active | Read only |
Number of Units | Read only |
Rental Type | Read only |
Insurance Agent / Policy Number / Contact Details | Read only |
Lease Return Charge Amount | Read only |
What this means in practice: You can update basic property info — address corrections, structure descriptions, reserves — from inside Aptly and it'll push to Buildium. But the Rental Type, active status, and insurance details are managed exclusively in Buildium, so don't build workflows that try to edit those fields from Aptly.
Units
Field | Sync Direction |
Unit Number / Abbreviation | Read/Write |
Address | Read/Write |
Unit Size / Total Area | Read/Write |
Bedrooms | Read/Write |
Bathrooms | Read/Write |
Market Rent | Read/Write |
Is Unit Listed / Published For Rent | Read/Write |
Description / Marketing Description | Read/Write |
Is Unit Occupied / Stage | Read only |
Building Name / Location Link | Read only |
What this means in practice: Marketing teams can manage listing status, market rent, and marketing descriptions from Aptly — useful when your leasing board automations need to flip a unit to "Published" upon vacancy. Occupancy status is read-only because Buildium derives it from active leases, so to mark a unit occupied you have to create the lease in Buildium (not toggle a field).
Leases & Tenants
Field | Sync Direction |
Lease From Date / Move In Date | Read/Write |
Lease To Date / End Date | Read/Write |
Lease Type | Read/Write |
Is Eviction Pending | Read/Write |
Tenant First Name / Last Name | Read/Write |
Tenant Email | Read/Write |
Tenant Phone Numbers | Read/Write |
Tenant Address | Read/Write |
Tenant Date of Birth (From Application Process) | Write only |
Lease Status / Stage | Read only |
Security Deposit | Read only |
Delinquency Balances (0-30 / 31-60 / 61-90 / 90+) | Read only |
Past Due Email Sent Date | Read only |
Is Notice Given | Read only |
Renewal Offer Status | Read only |
Cosigners | Read only |
What this means in practice: This is the board where understanding sync direction matters most.
- Lease dates, type, and tenant contact info can be edited from Aptly and will update Buildium. This is what makes renewal workflows possible directly from your renewals board.
- Delinquency balances are read-only — they're calculated by Buildium's accounting ledger. You can build automations off them (e.g., "if 31-60 balance is greater than $500, move card to Collections lane"), but you can't change the value from Aptly.
- Date of Birth is write-only. You can push it to Buildium from an application in Aptly, but if it's updated in Buildium later, Aptly won't pull the change.
- Lease Status, Notice Given, and Renewal Offer Status are all read-only because they're tied to Buildium's lease lifecycle logic. Change the underlying record in Buildium and the status updates everywhere.
Owners (Contacts)
Field | Sync Direction |
First Name / Last Name | Read only |
Company Name | Read only |
Email / Alternate Email | Read only |
Phone Numbers | Read only |
Address | Read only |
Management Agreement Start Date / End Date | Read only |
Tax Information | Read only |
Property IDs (Linked Properties) | Read only |
What this means in practice: The Owner contacts are read-only and attached to the Building. Owner records must be created and edited in Buildium. Aptly pulls owner data for use in your owner communications, reporting boards, and automations, but any owner updates need to happen in Buildium first.
Vendors
Field | Sync Direction |
Is Company | Read/Write |
Is Active | Read/Write |
First Name / Last Name | Read/Write |
Company Name | Read/Write |
Primary Email | Read/Write |
Website | Read/Write |
Account Number | Read/Write |
Address | Read/Write |
Phone Numbers (Home / Work / Mobile) | Read/Write |
Tax ID / Include In 1099 | Read/Write |
Category | Read/Write |
Expense GL Account | Read only |
Vendor Insurance | Read only |
Comments | Read only |
What this means in practice: Vendors are one of the most flexible entities in the integration. You can fully onboard a new vendor from Aptly — name, contact info, tax setup, category — and it'll create the record in Buildium. GL account assignment and vendor insurance remain Buildium-managed because they're tied to accounting and compliance workflows.
Work Orders
Field | Sync Direction |
Title / Name | Read/Write |
Work Details / Description | Read/Write |
Invoice Number | Read/Write |
Chargeable To | Read/Write |
Entry Allowed | Read/Write |
Entry Notes | Read/Write |
Vendor Notes | Read/Write |
Vendor / Vendor Link | Read/Write |
Priority | Read/Write |
Status / Stage | Read/Write |
Due Date | Read/Write |
Assigned To User / Assignee | Read/Write |
Property / Location Link | Read/Write |
Unit / Unit Link | Read/Write |
Amount | Read only |
Entry Contacts / Related Contacts | Read only |
Status (Completed / Cancelled) | Read only |
What this means in practice: Work orders are designed for two-way sync because maintenance is typically the most operational workflow in Aptly. You can create a work order in Aptly — assign vendor, set priority, link the unit — and it'll appear in Buildium. The Amount field is read-only because it's pulled from the linked bill/invoice in Buildium's accounting side.
How to Set Up Your Boards Around This
Step 1: Connect the Buildium integration
Go to Settings → Integrations → Buildium and follow the connection flow. You'll need your Buildium API credentials (your Buildium admin can generate these from Buildium → Settings → API Keys).
Step 2: Confirm your sync is active
After connecting, navigate to your Properties, Units, Leases, and Vendors boards. You should see your Buildium records populating as cards within a few minutes for a small portfolio, longer for portfolios over 1,000 units.
Step 3: Identify which fields you'll actually use
Before building any boards or automations, look at the tables above and circle which fields your team needs to edit from Aptly vs. which they just need to see. This decision drives how you build the rest of your workflows.
Step 4: Build mirror fields where needed
If you want a field from one Buildium-synced board to appear on a different board (for example, showing Market Rent from the Units board on a Leasing pipeline board), use a mirror field that pulls from the synced source field. Mirror fields inherit the sync direction of the source — so a mirror of a read-only field is also read-only.
Important Notes
Read-only fields should not be edited
If a field is read-only in the sync, it's read-only for everyone in Aptly. If you The fix is always: update it in Buildium and let it flow back.
Sync is not instant
Updates typically propagate within a few minutes, but during high-volume periods (end of month, mass lease renewals) it can take longer. If you're testing a workflow and don't see a change immediately, give it a few minutes before assuming something is broken.
Deletions don't always cross over
Aptly is conservative about deletions. Archiving or removing a card in Aptly will not delete the underlying record in Buildium. If you need to delete a property, lease, or vendor permanently, do it in Buildium.
Custom fields in Buildium do not sync
Only the fields listed in the tables above sync between systems. Custom fields you've created in Buildium will not appear in Aptly. If you need additional data points, create them as custom fields directly in Aptly — they'll live alongside the synced fields.
Date of Birth is write-only
This is intentional. You can collect a tenant's DOB through Aptly Screening and push it to Buildium, but changes made in Buildium afterward won't pull back. If your tenant intake process lives in Aptly, treat Aptly as the source of truth for this one field.
Best Practices
Use Buildium as your accounting source of truth
Anything tied to money — security deposits, delinquency, GL accounts, owner tax info — should be managed in Buildium. These are deliberately read-only in Aptly to prevent accidental edits that could create accounting discrepancies.
Use Aptly as your operational source of truth
Workflows that involve coordination, communication, and tasks — leasing, renewals, maintenance dispatch, vendor onboarding — belong in Aptly. The read/write fields are specifically the ones property managers touch most often in those workflows.
Build your renewals board off lease end dates
Since Lease To Date is read/write, you can build a full renewal workflow in Aptly: surface leases expiring in the next 90 days, run your renewal offer process, then update the end date from Aptly — and it'll flow back to Buildium when the renewal is signed.
Use delinquency balances as automation triggers, not editable values
A common pattern: build a Collections board where cards automatically move lanes based on which delinquency bucket they fall into (0-30, 31-60, 61-90, 90+). The buckets are read-only, but they're powerful as triggers for assigning tasks, sending notices via Aptly's email tool, or escalating to legal.
Keep vendor onboarding in Aptly
Because nearly every vendor field is read/write, you can build a clean vendor intake workflow in Aptly — collect W-9 info, set the 1099 toggle, categorize them — and the vendor will appear fully formed in Buildium. This is much faster than going back and forth between systems.
Don't mirror fields you don't need
It's tempting to mirror every Buildium-synced field onto every board, but mirror fields add visual clutter and can slow board performance. Only mirror what you'll actually use for filtering, automations, or display.
Troubleshooting
"I edited a field in Aptly and it didn't update in Buildium."
Check the sync direction in the table above. If the field is read only, edits made in Aptly won't persist — the next sync will overwrite them with Buildium's value. The fix is to make the change in Buildium instead.
"A new lease/unit/vendor I created in Buildium isn't showing up in Aptly."
First, give it 24 hours. If it still isn't appearing, check:
- Is the record marked active in Buildium? Inactive records may not sync.
- Is the parent record (e.g., the property for a new unit) already synced into Aptly? Child records won't appear until the parent does.
- Go to Settings → Integrations → Buildium and check the sync log for any errors.
"My automation is supposed to update a field but nothing's happening."
Most likely you're trying to set a read-only field. Open the automation, check which field it's writing to, and cross-reference the table above. If it's read-only, the automation needs to be redesigned — either to write to a different (Aptly-only) field, or to trigger a notification telling someone to make the change in Buildium.
"Delinquency balances look outdated."
Delinquency is calculated by Buildium based on the latest accounting transactions. If a payment was just posted, the balance update may not have processed in Buildium yet. Verify the balance in Buildium first — if it's correct there, give Aptly a few hours to pull the update.
"Tenant contact info is different between Aptly and Buildium."
Tenant contact fields are read/write, which means they can be edited in either system. If they're out of sync, someone may have edited one side during a brief sync delay. The most recent edit should win on the next sync cycle. If the discrepancy persists, update in Buildium directly and the value will flow back to Aptly.
"I deleted a card in Aptly but the record is still in Buildium."
This is expected behavior. Aptly does not propagate deletions to Buildium. To fully remove a record, delete it in Buildium — and the Aptly card will follow.
If you run into a sync issue not covered here, reach out to your dedicated Aptly account team with the board name, card name/link, and field name involved, and we'll investigate from the integration logs.
