This route can be used to make connection suggestions. For a property and source, you can propose one of three different actions: create, update or delete a connection.
See the explanations on what a connection is and how to check existing connections on Company Sources.
All suggestions are manually moderated to ensure appropriate connections and therefore accurate review data. Olery reserves the right manage all properties connections as it sees fit.
- If a source does not yet have a connection, you can use the
createaction to suggest one.
- If you believe an existing connections is incorrect (e.g. different hotel with similar name)
you can use the
updateaction to suggest an different URL.
- If the property does not have a
profile on a source, but there is an incorrect connection, you can use the
For a property, each source/connection can have only one pending suggestion. Posting another suggestion before moderation will override the details of the previous suggestion.
All suggestions are manually moderated, usually within 3 days. You can check the moderation
rejected) using the Company Sources endpoint.
Once a create/update suggestion is approved, the reviews should be available within 12 hours. In case of an update, the previously captured reviews will be deleted.
The data is supposed to represent the online reputation of the property, positive and negative. Therefore, we need to make sure that the connections are accurate and as complete as possible.
Please make sure the user is following these requirements when making suggestions:
- follow the pattern and instructions when submitting a URL
- each source can have only one connection (exception: AirBnB)
- only suggest connections which directly belong to the property
- do not suggest connections for related properties (e.g. the same group, chain, collection, competitor)
- if a business consists of multiple locations (e.g. hotel with restaurants), then these are usually separate properties (when in doubt, follow the structure as on TripAdvisor and activate all required properties)
- do not suggest to delete a connection because the reviews are negative, untrustworthy or considered unimportant
|Parameter||Parameter Type||Data Types||Required||Description|
|company_id||path||Integer||true||ID of the company|
||Name of the source|
||ID of the connection|
|data||Array||The newly created suggestion record|
|error||String||Error message for the user if the request was not successful|
data key, property details are returned.
|id||Integer||ID of the suggestion|
|company_id||Integer||ID of the property|
|source_id||Integer||ID of the source|
|connection_id||Integer||ID of the connection, empty for action
|suggested_url||String||Suggested URL, empty for action
|reject_reason||String||Reason if the suggestion was rejected|
|status||String||Status of the suggestion|
|created_at||Time||Date and time of suggestion creation|
|moderated_at||Time||Date and time of moderation|
|403||You don’t have access to that company|
|422||Some of the supplied arguments are not valid|