How can we help? 👋

Buildium API: What Syncs?

What syncs with the Buildium API

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:

  1. Is the record marked active in Buildium? Inactive records may not sync.
  1. 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.
  1. 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.

 
Did this answer your question?
😞
😐
🤩