Experience the difference of "Elite".

Getting Started

Core Concepts

Overview

Bookings & Quotes

Damage Protection

Data Management

Deposits

Email Template Library

Fields

Guests

Integrations

Listing Site Integration

Messaging

My Account

Payment Processing

Privacy & Security

Properties

Property Management

Quotes

Rates

Renter Agreements

Reporting

Reviews

Rules

Security Deposits

Suppressed Email Addresses

Tags

Taxes

Team Access

Technical Stuff

Travel Insurance

Triggers

Verified Email Domains

Channel Management

Channel Management

API Integrations

Calendar Import/Export

Channel Bridge

Integrations

OwnerRez APIs

Payment Processing

Testing

Websites

Change Log

2024

2023

2022

2021

2020

2019

Staff Reference

Listing Site Integration - Inquiry parsing for emails using custom SMTP headers

Send each inquiry email to the @inquiryspot.com email address that we provide for each OwnerRez user.  The first part of the email address should be the "oruxxxxxx" formatted number that is unique to each OwnerRez user account.  If you are integrated as a first-class channel, this email address is provided as the <inquiryEmail> element in the advertiser index feed.

When creating the email to send, your email code should append custom SMTP headers to the email which our inquiry parsing engine looks for automatically when the email arrives.  This allows us to maintain consistency in parsing the inquiry values even if your message body changes over time.

Testing parsed inquiry emails only work in the OwnerRez PROD environment, so users must have a PROD account to successfully test inquiry emails.

These are the custom SMTP headers our inquiry parsing engine looks for:

NOTE - any data shown here is example data only!  Do not actually use orp5b490bbx, Machelle Patterson, etc. - use the appropriate values for your particular case.

X-Inquiry-Listing: 125821
X-Inquiry-ExternalListingId: orp5b490bbx
X-Inquiry-Name: Machelle Patterson
X-Inquiry-Arrival: 2021-05-13
X-Inquiry-Departure: 2021-05-17
X-Inquiry-Adults: 2
X-Inquiry-Children: 3
X-Inquiry-Pets: 0
X-Inquiry-Comments: Love your place! Can we get a bouncy house?
X-Inquiry-Phone: (123) 456-7890
X-Inquiry-Email: guest@acme.com
X-Inquiry-Id: 029c37c2894646c18ae284ca09e57984
X-Inquiry-MessageId: ac2263d863af40a3ac2ed5141b15db54
X-Inquiry-TravelerSource: ACMEVACATIONS

Further Notes and Tips:

  • Listing is the listing number on the channel. It can be a text string or numeric.  It should be the identifier of the unique property or listing (ie. house) that the inquiry is being sent for.
  • ExternalListingId is the property number or listing identifier from OwnerRez.  This number should be in the "orpxxxxxx" format provided by OwnerRez and is common in our channel feeds.
  • Comments is optional and is the message or question the guest asked when submitting the inquiry.
  • Phone is optional.
  • Email is the guest's real email address where the reply (from the host) should be sent back to. If the guest email address isn't specified here, we'll look for a REPLY-TO header instead.
  • Id is optional. If specified, Id should be a string value unique to the inquiry so we can thread multiple messages to the same initial inquiry conversation.
  • MessageId is optional. If specified, MessageId should be a string value unique to the message so we can de-dupe. If you don't have multiple messages per inquiry, the Id and MessageId might be the same value.
  • TravelerSource is optional.  This is used to specify which sub-channel or sister listing site the channel sent the message from.  For instance, Vrbo might be the channel but the TravelerSource might have been Arbitrel.com or Holiday-Lettings or one of the child listing sites Vrbo owns.  Put a domain name as the value.  For instance, use "vrbo.com" instead of just "Vrbo".

Formatting:

  • Date fields (Arrival and Departure) are YYYY-MM-DD
  • Guest counts (Adults, Children, Pets) should be integers only, no commas or text