---
title: OwnerRez API Integration on Truto
slug: ownerrez
category: CRM
canonical: "https://truto.one/integrations/detail/ownerrez/"
---

# OwnerRez API Integration on Truto



**Category:** CRM  
**Status:** Beta

## MCP-ready AI tools

Truto exposes 82 tools for OwnerRez that AI agents can call directly.

- **create_a_owner_rez_booking** — Create a new booking.
- **get_single_owner_rez_booking_by_id** — Fetch a booking. Required: id.
- **list_all_owner_rez_bookings** — Query for a pageable list of bookings. Either property_ids or since_utc is required. The connector pages through all results (100 per page, or your limit up to 100), following next_page_url.
- **update_a_owner_rez_booking_by_id** — Partially update a booking. Required: id.
- **list_all_owner_rez_calendar_nights** — Fetch calendar nights for multiple properties. Each days entry is one night (date through the following morning), not a calendar day cell. On a turnover day, is_departure and booking_id refer to different bookings. Required: from, to. The connector pages through all results (100 per page, or your limit up to 100), following next_page_url.
- **list_all_owner_rez_current_users** — Fetch the user details for the currently authenticated user.
- **get_single_owner_rez_deposit_by_id** — Fetch a deposit. Required: id.
- **list_all_owner_rez_deposits** — Query for a pageable list of deposits. The connector pages through all results (100 per page, or your limit up to 100), following next_page_url.
- **create_a_owner_rez_discount** — Create a new discount.
- **delete_a_owner_rez_discount_by_id** — Remove a discount. Required: id.
- **get_single_owner_rez_discount_by_id** — Fetch a single surcharge/discount by id. Returns 404 when the id does not exist or a sign-ambiguous type's stored sign does not match this endpoint's collection. Required: id.
- **list_all_owner_rez_discounts** — Query for a pageable list of discounts. Discounts are the reusable discount templates (length-of-stay, promotions, and other reductions) applied to bookings. The connector pages through all results (100 per page, or your limit up to 100), following next_page_url.
- **update_a_owner_rez_discount_by_id** — Partially update a discount. Required: id.
- **get_single_owner_rez_fee_by_id** — Fetch a fee. Required: id.
- **list_all_owner_rez_fees** — Query for a pageable list of fees. Fees are the individual fee line items charged on a specific booking. The connector pages through all results (100 per page, or your limit up to 100), following next_page_url.
- **create_a_owner_rez_field_definition** — Create a new field definition.
- **delete_a_owner_rez_field_definition_by_id** — Remove a field definition. Required: id.
- **get_single_owner_rez_field_definition_by_id** — Fetch a field definition. Required: id.
- **list_all_owner_rez_field_definitions** — Fetch all possible field definitions. The connector pages through all results (100 per page, or your limit up to 100), following next_page_url.
- **update_a_owner_rez_field_definition_by_id** — Partially update a field definition. Required: id.
- **create_a_owner_rez_field** — Create a new field.
- **delete_a_owner_rez_field_by_id** — Remove a field. Required: id.
- **owner_rez_fields_detach** — Remove a specific field definition from an entity. Required: field_definition_id, entity_id, entity_type.
- **get_single_owner_rez_field_by_id** — Fetch a field. Required: id.
- **list_all_owner_rez_fields** — Fetch all field values defined for a single entity. Required: entity_id, entity_type. The connector pages through all results (100 per page, or your limit up to 100), following next_page_url.
- **update_a_owner_rez_field_by_id** — Partially update a field. Required: id.
- **delete_a_owner_rez_guest_address_by_id** — Remove a single address from a guest. Required: id, guest_id.
- **delete_a_owner_rez_guest_email_address_by_id** — Remove a single email address from a guest. Required: id, guest_id.
- **delete_a_owner_rez_guest_phone_by_id** — Remove a single phone number from a guest. Required: id, guest_id.
- **create_a_owner_rez_guest** — Create a new guest.
- **delete_a_owner_rez_guest_by_id** — Remove a guest. Required: id.
- **get_single_owner_rez_guest_by_id** — Fetch a guest. Required: id.
- **list_all_owner_rez_guests** — Query for a pageable list of guests. At least one of q, created_since_utc, from, or to is required. The connector pages through all results (100 per page, or your limit up to 100), following next_page_url.
- **update_a_owner_rez_guest_by_id** — Partially update a guest. Required: id.
- **get_single_owner_rez_inquiry_by_id** — Fetch an inquiry. Required: id.
- **list_all_owner_rez_inquiries** — Fetch all inquiries. The connector pages through all results (100 per page, or your limit up to 100), following next_page_url.
- **get_single_owner_rez_listing_site_by_id** — Fetch a listing site. Required: id.
- **list_all_owner_rez_listing_sites** — Fetch all listing sites available to the current user. The connector pages through all results (100 per page, or your limit up to 100), following next_page_url.
- **get_single_owner_rez_listing_by_id** — Fetch a listing. Amenities-only listing access returns the base listing and amenities. Rooms, bathrooms, images, and descriptions need the WordPress Plugin + Integrated Websites premium, full listing access, or a self-use OAuth app; otherwise those collections are omitted. > Behind a premium feature. Required: id.
- **list_all_owner_rez_listings** — Query for a pageable list of property listings. Amenities-only listing access returns the base listing and amenities. Rooms, bathrooms, images, and descriptions need the WordPress Plugin + Integrated Websites premium, full listing access, or a self-use OAuth app; otherwise those collections are omitted. > Behind a premium feature. The connector pages through all results (100 per page, or your limit up to 100), following next_page_url.
- **create_a_owner_rez_message** — Create a new message. > OAuth app required. Personal Access Tokens can't call messaging endpoints. Using your own account? Create an OAuth app and click Grant Access To Me — that's it. Third-party apps need a signed messaging agreement (email partnerhelp@ownerrez.com with the subject Messaging API Access).
- **get_single_owner_rez_message_by_id** — Fetch a message. > OAuth app required. Personal Access Tokens can't call messaging endpoints. Using your own account? Create an OAuth app and click Grant Access To Me — that's it. Third-party apps need a signed messaging agreement (email partnerhelp@ownerrez.com with the subject Messaging API Access). Required: id.
- **list_all_owner_rez_messages** — Fetch all messages on a single thread. > OAuth app required. Personal Access Tokens can't call messaging endpoints. Using your own account? Create an OAuth app and click Grant Access To Me — that's it. Third-party apps need a signed messaging agreement (email partnerhelp@ownerrez.com with the subject Messaging API Access). Required: threadId. The connector pages through all results (100 per page, or your limit up to 100), following next_page_url.
- **get_single_owner_rez_owner_by_id** — Fetch an owner. Required: id.
- **list_all_owner_rez_owners** — Fetch all owners. The connector pages through all results (100 per page, or your limit up to 100), following next_page_url.
- **get_single_owner_rez_payment_by_id** — Fetch a payment. Required: id.
- **list_all_owner_rez_payments** — Query for a pageable list of payments. The connector pages through all results (100 per page, or your limit up to 100), following next_page_url.
- **get_single_owner_rez_property_by_id** — Fetch a property. Required: id.
- **list_all_owner_rez_properties** — Fetch many properties. The connector pages through all results (100 per page, or your limit up to 100), following next_page_url.
- **list_all_owner_rez_property_calendar_nights** — Fetch calendar nights for a single property. Each days entry is one night (date through the following morning), not a calendar day cell. On a turnover day, is_departure and booking_id refer to different bookings. Required: from, to, property_id.
- **list_all_owner_rez_property_search_results** — Search for properties. The connector pages through all results (100 per page, or your limit up to 100), following next_page_url.
- **create_a_owner_rez_quote** — Create a new quote.
- **delete_a_owner_rez_quote_by_id** — Remove a quote. Required: id.
- **get_single_owner_rez_quote_by_id** — Fetch a quote. Required: id.
- **list_all_owner_rez_quotes** — Fetch all quotes. The connector pages through all results (100 per page, or your limit up to 100), following next_page_url.
- **update_a_owner_rez_quote_by_id** — Partially update a quote. Required: id.
- **get_single_owner_rez_refund_by_id** — Fetch a refund. Required: id.
- **list_all_owner_rez_refunds** — Query for a pageable list of refunds. The connector pages through all results (100 per page, or your limit up to 100), following next_page_url.
- **get_single_owner_rez_review_by_id** — Fetch a review. > Behind a premium feature. Using your own account? Create an OAuth app and click Grant Access To Me — no premium needed. Required: id.
- **list_all_owner_rez_reviews** — Get a page of reviews. > Behind a premium feature. Using your own account? Create an OAuth app and click Grant Access To Me — no premium needed. The connector pages through all results (100 per page, or your limit up to 100), following next_page_url.
- **owner_rez_spot_rates_bulk_update** — Create and/or partially update multiple spot rates.
- **list_all_owner_rez_spot_rates** — Fetch raw spot-rate overrides. Returns only nights where a spot-rate override exists (sparse). For effective computed nightly pricing, use GET /v2/calendar. The connector pages through all results (100 per page, or your limit up to 100), following next_page_url.
- **create_a_owner_rez_surcharge** — Create a new surcharge.
- **delete_a_owner_rez_surcharge_by_id** — Remove a surcharge. Required: id.
- **get_single_owner_rez_surcharge_by_id** — Fetch a single surcharge/discount by id. Returns 404 when the id does not exist or a sign-ambiguous type's stored sign does not match this endpoint's collection. Required: id.
- **list_all_owner_rez_surcharges** — Query for a pageable list of surcharges. Surcharges are the reusable fee, adjuster, and promotion templates that generate charges on bookings. The connector pages through all results (100 per page, or your limit up to 100), following next_page_url.
- **update_a_owner_rez_surcharge_by_id** — Partially update a surcharge. Required: id.
- **create_a_owner_rez_tag_definition** — Create a new tag definition.
- **delete_a_owner_rez_tag_definition_by_id** — Remove a tag definition. Required: id.
- **get_single_owner_rez_tag_definition_by_id** — Fetch a tag definition. Required: id.
- **list_all_owner_rez_tag_definitions** — Fetch a pageable list of all possible tags. The connector pages through all results (100 per page, or your limit up to 100), following next_page_url.
- **update_a_owner_rez_tag_definition_by_id** — Partially update a tag definition. Required: id.
- **create_a_owner_rez_tag** — Add a tag to an entity. Required: entity_id, entity_type.
- **delete_a_owner_rez_tag_by_id** — Remove a tag. Required: id.
- **get_single_owner_rez_tag_by_id** — Fetch a tag. Required: id.
- **list_all_owner_rez_tags** — Fetch all tags applied to a single entity. Required: entity_id, entity_type. The connector pages through all results (100 per page, or your limit up to 100), following next_page_url.
- **owner_rez_tags_untag** — Remove a specific tag name from an entity. Required: name, entity_id, entity_type.
- **list_all_owner_rez_webhook_categories** — Fetch all webhook categories.
- **create_a_owner_rez_webhook_subscription** — Create a new webhook subscription. Required: webhook_url.
- **delete_a_owner_rez_webhook_subscription_by_id** — Remove a single webhook subscription. Required: id.
- **get_single_owner_rez_webhook_subscription_by_id** — Fetch a single webhook subscription. Required: id.
- **list_all_owner_rez_webhook_subscriptions** — Fetch all webhook subscriptions. The connector pages through all results (100 per page, or your limit up to 100), following next_page_url.

## How it works

1. **Link your customer's OwnerRez account.** Use Truto's frontend SDK; we handle every OAuth and API key flow so you don't need to create the OAuth app.
2. **Authentication is automatic.** Truto refreshes tokens, stores credentials securely, and injects them into every API request.
3. **Call Truto's API to reach OwnerRez.** The Proxy API is a 1-to-1 mapping of the OwnerRez API.
4. **Get a unified response format.** Every response uses a single shape, with cursor-based pagination and data in the `result` field.

## Use cases

- **Power AI guest messaging for STR operators** — Give your AI concierge or guest experience product native access to OwnerRez inboxes so your users can automate replies across Airbnb, Vrbo, and Booking.com without leaving your app. Truto handles the OAuth and messaging scopes so you can focus on conversation quality.
- **Automate housekeeping and field operations** — Let cleaning and maintenance platforms sync OwnerRez bookings, calendar nights, and check-in/check-out changes in real time to auto-schedule turnovers. Avoid double-dispatches by reacting to booking state changes via webhooks.
- **Push dynamic pricing into OwnerRez calendars** — Revenue management and dynamic pricing SaaS can pull occupancy signals and push bulk spot rate updates back into OwnerRez without overwriting base rate logic. Perfect for teams distributing nightly rates to multiple channels.
- **Convert OTA guests into direct bookings** — Marketing CRMs can extract real guest contact data from OwnerRez, launch retargeting campaigns, and auto-apply discount codes to quotes on the manager's direct booking site. Close the loop from campaign click to confirmed reservation.
- **Build vacation rental analytics and reporting** — BI and accounting tools can aggregate bookings, payments, refunds, deposits, fees, and surcharges across every connected OwnerRez account. Deliver portfolio-level dashboards without building per-tenant ETL pipelines.

## What you can build

- **Two-way unified inbox sync** — Read guest message threads with list_all_owner_rez_messages and post AI-generated replies back using create_a_owner_rez_message so conversations stay in the native OTA inbox.
- **Real-time booking and calendar webhooks** — Programmatically subscribe to OwnerRez webhook categories to receive booking, calendar, and message events the moment they happen — no polling required.
- **Bulk spot rate publishing** — Push nightly price overrides into any property calendar using owner_rez_spot_rates_bulk_update, with full visibility into current rates via list_all_owner_rez_spot_rates.
- **Guest CRM enrichment** — Pull full guest profiles, addresses, phone numbers, and emails via list_all_owner_rez_guests to power segmentation, lookalike audiences, and loyalty programs.
- **Automated discount and quote generation** — Create targeted promo codes with create_a_owner_rez_discount and generate shareable quotes via create_a_owner_rez_quote to drive direct bookings from marketing campaigns.
- **Custom fields and tagging layer** — Define and manage custom fields and tags on OwnerRez objects to persist your app's metadata (segment, lifecycle stage, cleaning status) directly in the PMS.

## FAQs

### How do end users authenticate their OwnerRez account?

OwnerRez uses OAuth for third-party app connections. Truto handles the full OAuth flow, token storage, and refresh so your users click 'Connect OwnerRez' and you receive a ready-to-use connection.

### Can we receive real-time events instead of polling?

Yes. OwnerRez supports webhooks for bookings, messages, and calendar changes. You can use create_a_owner_rez_webhook_subscription to register endpoints and list_all_owner_rez_webhook_categories to discover available event types. Truto normalizes delivery and retries.

### Is messaging access available to all apps?

OwnerRez gates its messaging endpoints (list_all_owner_rez_messages, create_a_owner_rez_message) behind stricter OAuth scopes and premium plan requirements. Your end users may need an eligible OwnerRez subscription for inbox automation features to work.

### How do we push dynamic pricing without breaking base rates?

Use owner_rez_spot_rates_bulk_update to inject night-by-night overrides. Spot rates sit on top of foundational rate logic, so you can experiment with pricing without disturbing the manager's base configuration.

### Can we store app-specific metadata on OwnerRez records?

Yes. OwnerRez supports custom field definitions and tags. You can create definitions with create_a_owner_rez_field_definition and create_a_owner_rez_tag_definition, then attach values to guests, bookings, and other objects.

### What booking and reservation data is available?

You can list and fetch bookings, quotes, inquiries, payments, refunds, deposits, fees, surcharges, discounts, reviews, calendar nights, properties, listings, and owners. This covers nearly every object needed for operations, accounting, and guest experience workflows.

### How does Truto handle pagination and API quirks?

Truto abstracts OwnerRez's pagination, rate limits, and auth refresh behind a single consistent interface. You call a list endpoint and get normalized results across all your tenants without writing per-API retry or cursor logic.
