Selectively Enabling Properties
Some PMSs give access to more properties than you may want data for. It's common to have one of your customers want to run your product on only a select list of their properties. In this case, it can be cumbersome to sift through data from all their properties when you only need a small amount of relevant data.
To resolve this common situation, we support explicitly enabling and disabling ingestion of property data. We offer the ability to configure this either by our API or the Propexo Dashboard.
By default, an integration has all properties set to be enabled. This can be configured via the Propexo API and/or Dashboard.
How it works
When creating an integration (via the API or Dashboard), you'll have the option to enable or disable ingestion of all properties (see image below).
The default setting is to always ingest all properties. If this option is disabled, Propexo will not automatically populate child data for any properties as part of the first sync. Instead, once an initial sync has finished, a list of the available properties will be populated for you to inspect via the API or the Dashboard. You can selectively enable and disable properties as appropriate for your use case. After this, subsequent syncs will ingest data for the properties that remain enabled, and those listed as disabled will be ignored.
To view the list of properties and their ingestion status via the API, you can use
If you want to change the status of one of these properties, you can use
Note that the last path parameter isn't the property ID, it's the id of the property configuration, which is identified by the
id field on the
For example, if we received the following list of properties from our
And we wanted to stop ingesting data for property id
c4d912598f9c01516794f5a25c285fa41456, we would get it's property configuration id (
c9ad28d1f8a9e78522bd89567ce8a13a6) and make the following request:
This would stop future processing of records related to the property with id
That means we won't read any data about units, residents, leases, etc when they're related to that property.
The list of properties for an integration can be viewed on that integration's page, near the bottom.
Each property that belongs to the integration is listed, along with whether it is disabled or not. If you go to the ellipsis on the right side, you can choose to enable or disable the property.
Once this is changed, the next sync for this integration will take these new settings into account.