​
Integration Requirements

To begin your Rentvine integration with Latchel, you’ll need to obtain your Rentvine credentials or API keys. Please follow the steps below to retrieve this essential information. The Latchel engineering team will need 3 pieces of data:
  1. API key
  2. API secret
  3. Customer subdomain. This subdomain is found in the URL of your portal. It is the first bit after “https://”. In the screenshot below, the subdomain is “demopm5”.
Screenshot2025 05 21114010 Pn

​
Obtaining the Rentvine Credentials

Follow these steps to setup an API Key. Login to Rentvine, navigate to Settings>Account>User, Roles and API Keys.
Reports 05 22 2025 07 52 AM Pn
Settings 05 22 2025 07 53 AM Pn
Go to Api tab, then click New API Key. Enter “Latchel” as the Name and select “Administration” as the Role. Then click Save.
Settings Account Users Api 05 22 2025 07 53 AM Pn
Settings Account Users Api 05 22 2025 07 54 AM Pn
Copy and paste the text (do not take a screenshot) of the of the returned API Key and API Secret and send it to your Customer Success Manager, or Latchel product support contact.
1image 20250514 201526 05 21 2025 01 09 PM Pn

​
Get Property and Resident Data from Rentvine

This step is only necessary if you already have existing property and resident records in Latchel.
To proceed with assigning reference IDs to your existing data in Latchel and avoid creating duplicate records, you must follow the steps below to export two CSV files:
  1. Lease Tenants Report – This report includes the Property ID and Unit ID.
  2. Tenants Report – This report includes the Tenant ID.
Both reports must be downloaded before continuing.
  1. Lease Tenants Report
Download the csv reports. First, export report of Lease Tenants. Go to Reports, search for “tenants” to show both Lease Tenants, and Tenants. Export the property report with Property ID, and Unit ID by choosing Lease Tenants. Then click Build Report.
Reports 05 22 2025 07 28 AM Pn
Reports Lease Tenants 05 22 2025 07 32 AM Pn
Then click Columns, make sure to check the boxes for Property ID, and Unit ID. Click Export, and save it on your computer as prompted.
Reports Lease Tenants 05 22 2025 07 46 AM Pn
  1. Tenants Report
Obtain the Tenant ID by going to: Reports > Tenants. Choose only Active tenants, then click Build Report. Make sure the Tenant ID column is selected, then click Export to download the report.
Reports 05 22 2025 07 43 AM Pn
Reports Tenants 05 22 2025 07 44 AM Pn
Reports Tenants 05 22 2025 07 47 AM Pn
Finally, forward both of these reports to your Customer Success Manager or the Latchel Product Support team by emailing team@latchel.com or success@latchel.com. You may include your API keys in the same email for convenience.

​
What happens when a customer first activates their integration?

When an admin first activates the customer’s Rentvine integration nothing happens immediately. The integration will be active and will be scheduled for hourly imports. A. Properties The following Property fields are brought over from Buildium to Latchel.
Buildium FieldValue/Interpretation in Latchel
PropertyIdref_property_id
UnitIdref_unit_id
addressaddress1
address2address2
citycity
stateIDstate
postcalCodezip
blankcriticalNote
unit.isActiveproperty.is_active
name, unit nameintegration_data
Automatic Property ReconcillationTo ensure accurate customer billing Latchel runs on automated process each month to de-activate any active units in Latchel that no longer exist in Buildium. This process currently happens on the 27th at 3am PST. Learn more of how this works by going to How Latchel Integration Works.
When a property is deactivated through the reconcillation process, it will be logged to the property in Latchel as:Image 20231219 185054 05 21 2025 12 39 PM Pn
B. Residents The following resident fields are synced from Rentvine to Latchel. Currently, we sync all eligible residents during each sync. All residents on a property are included to ensure that any of them can submit a work order in Latchel.
Rentvine FieldValue/Interpretation in Latchel
contactIDref_user_id
namename
emailemail
phonePrimary phone number*
propertyIdref_property_id
unitIdref_unit_id
Move In Datemove_in_date
Move Out Datemove_out_date
Previously-created residentsOnce a resident is created we only change a few things on subsequent syncs:
  • Property/unit associations
  • Move in / move out dates
    • When a resident is passed their move-out date, we’ll mark them inactive at the relevant property in Latchel.
C. Work Orders Unlike properties and residents, which only sync from Rentvine to Latchel, work orders sync both ways—Rentvine to Latchel and Latchel to Rentvine.
  • Rentvine → Latchel
The Rentvine integration syncs work orders that have been created in the last 72 hours.
Platform fieldField/Interpretation in Latchel
Work order Numberorder_number
Idref_job_id
Description: first 50 charactersname
DescriptionDescription
scheduled Start Datescheduled_start
StatusIf the work order is for a vacant unit, set the status to “Scheduling with Vendor.” For occupied units, set it to “Diagnosing Issue.” The platform’s status does not influence the initial status Latchel assigns to the work order.
Priorityis_urgent is true if Priority is “High”
ContactID or tenant IDref_user_id
Maintenance Work Orders 05 22 2025 12 44 PM Pn
  • Latchel → Rentvine
Work orders are synced to Rentvine a few seconds after they are created in Latchel.
Field in LatchelField/Interpretation in Platform
order_numberOrder number is synced back to Latchel and updated in Latchel to reflect the order number in Rentvine
name + descriptiondescription
vendor_instructionsVendor Instructions
is Shared With TenantEntry Notes
is Shared With OwnerVendor Id Latchel vendor - we create and add a “Latchel Vendor” for this purpose
priority IDif is_emergency: 3, else 2
work Orde Status IDalways closed for now
is Vacantis_vacant
requested By Contact IDtenant_id
ref_property_idproperty ID
ref_unit_idunit ID
Latchel 05 22 2025 12 45 PM Pn
Latchel files do not sync to Rentvine at this time.