Aptly integrates with Rentvine via API. All you’ll need handy are two browser tabs, Aptly and Rentvine.

How the Integration Works

Before you start, it helps to understand that the connection is built from two pieces that work together. Setting up only one of them is the most common reason a sync looks like it isn’t working.

1. The API key unlocks the door. Your Rentvine API key and secret give Aptly permission to read your Rentvine data, and to write back to it when you enable that. Nothing flows between the two systems without it.

2. Webhooks tell Rentvine when to push. Webhooks are enabled inside Rentvine and tell it that when something happens there, such as a property, unit, lease, or work order being created or updated, it should push that change down to Aptly right away. Without webhooks, Aptly is waiting on the scheduled sync instead of hearing about changes as they happen.

The combination is what makes the integration feel live. The API is the permission. The webhooks are the signal.

3. Data Sync Mapping decides which system owns the record. Once data is flowing, you fine tune the integration by choosing, entity by entity, whether Aptly can only read from Rentvine or can also update and create records in it. Read Only means Rentvine stays the master record. Update/Create means your team can drive work from Aptly and have it land in Rentvine. Which one you choose per entity should follow how your team actually works.

<aside> ⚠️

Decide where each part of your workflow happens. If you have Update/Create enabled and a user edits the same record in Rentvine while someone else edits it in Aptly, the two changes collide and one system ends up overwriting the other. Agree with your team on which system is used for which task before you turn on Update/Create, so these settings match your workflow instead of fighting it.

</aside>

https://vimeo.com/1219383134/a877cc986e?share=copy&fl=sv&fe=ci

How to Prepare for an Aptly/Rentvine Integration

Before setting up your integration, you’ll need to grab your API key from Rentvine.

<aside> 💡 If you are making the switch from any other property management software to Rentvine, please notify our team so that we can support you in this transition. Email us at [email protected].

</aside>

Get your Rentvine API Key and Secret

  1. In Rentvine, click the ellipses next to your name in the lower left corner and select Settings.

    image.png

    image.png

  2. Under Account, click Users, Roles, and API.

    image.png

  3. Confirm you have a Role for the key to use. Creating an API key is an Administrator level action, and Aptly needs full access to sync properly, so we recommend an Administrator role. If you do not already have one, open the Roles tab, click New Role, select the permissions, and Save.

    rentvine-roles-tab.png

  4. Open the Api tab and click New API Key in the upper right.

    image.png

    1. Title the API Key Aptly.

    2. Select your Administrator role.

      image.png

    3. Save.

  5. Copy both the Access Key and the Secret to use in Aptly. Rentvine displays the secret only once. If you close the window before copying it, you will need to generate a new secret.

    image.png

    <aside> 💡

    If you use Update Secret or Delete Key in Rentvine, the old credentials stop working immediately. Your Aptly sync will fail until you paste the new values into Aptly.

    </aside>