Cloudbeds data reference

Learn what data syncs from Cloudbeds to Klaviyo and where to view it. This includes reservations, guest information, and email consent. If you have not already, read our guide on getting started with Cloudbeds for step-by-step instructions on integrating, before continuing with this article.

Sync frequency

When you integrate with Cloudbeds, Klaviyo syncs historical guest data and looks back approximately 2 years for reservation data. Going forward, reservation and guest data sync in real time.

How to view your Cloudbeds data

To view your Cloudbeds data:

1. Navigate to Analytics > Metrics.
2. Here, you can view all of the metrics in your account. The metrics with a Cloudbeds icon represent all of the metrics synced from your Cloudbeds integration.
3. Use the Integration filter and select Cloudbeds to view only Cloudbeds metrics.

Room Night metrics

The following room night metrics, related to reservations, are synced from Cloudbeds:

• Confirmed Room Night
  When a guest confirms a reservation in Cloudbeds, we create 1 Confirmed Room Night event per room night (e.g., a reservation with 2 rooms for 2 nights will have 4 events).
• Completed Room Night
  When a guest checks out in Cloudbeds, we create 1 Completed Room Night event per room night (e.g., a reservation with 2 rooms for 2 nights will have 4 events).

Room night events are only synced for nights with a room rate in Cloudbeds. Nights without a rate are excluded.

Confirmed Room Night events are dated to the reservation’s creation time. Completed Room Night events are dated to 11:59 p.m. on each night in the property’s time zone, even though they sync when the guest checks out.

For each of these metrics, the following top-level properties are synced to Klaviyo:

• Value
  The total value of the room (i.e. room revenue) for a given night.
• Id
  The Klaviyo-generated ID associated with the room night.
• ReservationID
  The ID associated with the Reservation in the PMS.
• StartDate
  The date a night begins.
• EndDate
  The date a night ends.
• DayOfWeek
  The day of the week (e.g. Monday) when the night begins.
• AdultCounts
  Number of adults in a room.
• ChildCounts
  Number of children in a room.
• PersonCounts
  Number of people in a room (i.e. sum of adults and children).
• RoomTypeName
  The name of the room type as stored in Cloudbeds.
• PropertyID
  ID corresponding to the hotel.
• PropertyName
  Name corresponding to the hotel property.
• Source
  The source the reservation was booked from (e.g., “Website/Booking Engine”).
• MarketCode
  Market code for the room.

Reservation metrics

The following reservation metrics are synced from Cloudbeds:

• Created Reservation
  When a reservation is created with an unconfirmed status in Cloudbeds. The historical sync also creates this event for reservations with other statuses.
• Confirmed Reservation
  When a guest’s reservation is confirmed in Cloudbeds.
• Checked In to Reservation
  When a guest checks in to their reservation.
• Checked Out of Reservation
  When a guest checks out of their reservation.
• Cancelled Reservation
  When a guest or admin cancels a guest’s reservation.
• No Show Reservation
  When a guest does not show up to a reservation.

For each of these metrics, the following top-level properties are synced to Klaviyo:

• Value
  The total monetary value of the reservation.
• Reservation ID
  The reservation ID from Cloudbeds.
• Nights
  The number of nights of a reservation.
• Property ID
  The ID of the property that the reservation was booked at (e.g., “12345”).
• Property Name
  The name of the property that the reservation was booked at (e.g., “Boutique Hotel in Maine”).
• Property Image
  The list of property images from Cloudbeds, including their image URLs.
• Source
  The source the reservation was booked from (e.g., “Website/Booking Engine”).
• Source ID
  The ID of the source of the reservation (e.g., “s-1”).
• Origin
  The origin of the reservation (e.g., “Expedia”).
• Third Party Identifier
  If the reservation came from an online travel agency (OTA), the ID of the reservation in that system.
• Estimated Arrival Time
  The estimated time the guest will arrive at the property.
• Start Date
  The start date for the reservation.
• End Date
  The end date for the reservation.
• Allotment Block Code
  The allotment block code that was used on the reservation.
• Additional Products Value
  The value of any add-ons a guest purchased on their reservation.
• Additional Products Item Count
  The total number of additional products that a guest purchased on their reservation.
• Reservation Person Counts
  The number of people in assigned rooms on the reservation. If no assigned-room counts are available, this is 1.
• Reservation Adult Counts
  The number of adults in assigned rooms on the reservation. If no assigned-room counts are available, this is 1.
• Reservation Child Counts
  The number of children in assigned rooms on the reservation. If no assigned-room counts are available, this is 0.

Reservation objects

The latest version of the Cloudbeds integration (upgrade guide) syncs Reservation objects from Cloudbeds. These have the following fields:

• Value
  The total monetary value of the reservation.
• ValueCurrency
  The currency code configured for the property in Cloudbeds.
• ReservationID
  The reservation ID from Cloudbeds. Used as the object ID.
• ReservationStatus
  The current status of the reservation.
• ReservationNights
  The number of nights of a reservation.
• PropertyID
  The ID of the property that the reservation was booked at (e.g., “12345”).
• PropertyName
  The name of the property that the reservation was booked at (e.g., “Boutique Hotel in Maine”).
• PropertyImage
  The main image URL for the property.
• Source
  The source the reservation was booked from (e.g., “Website/Booking Engine”).
• SourceID
  The ID of the source of the reservation (e.g., “s-1”).
• Origin
  The origin of the reservation (e.g., “Expedia”).
• ThirdPartyIdentifier
  If the reservation came from an online travel agency (OTA), the ID of the reservation in that system.
• EstimatedArrivalTime
  The estimated time the guest will arrive at the property.
• StartDate
  The start date for the reservation.
• EndDate
  The end date for the reservation.
• AllotmentBlockCode
  The allotment block code that was used on the reservation.
• RoomTypeName
  The room type name of the first assigned room on the reservation.
• AdditionalProductsValue
  The value of any add-ons a guest purchased on their reservation.
• AdditionalProductsItemCount
  The number of additional-product entries on the reservation, rather than the sum of their quantities.
• ReservationPersonCounts
  The total number of people included on a reservation.
• ReservationAdultCounts
  The total number of adults included on a reservation.
• ReservationChildCounts
  The total number of children included on a reservation.

Guest data

Klaviyo syncs guest data from Cloudbeds when the guest has a valid email address or phone number. Anonymized guest records are excluded. Masked email addresses from known online travel agency (OTA) domains, such as Booking.com and Expedia, are excluded, but a guest with a valid phone number can still sync as a phone-only profile. Reservation metrics, room night metrics, and reservation objects require a non-OTA email address.

If a guest who booked through an OTA later provides their real email in Cloudbeds (for example, through a check-in form), Klaviyo creates or updates their profile. With the latest version of the integration, Klaviyo also backfills their past reservations as reservation objects, so they can be used in date-based segments and flows. Upcoming reservations continue to sync as usual.

We sync the following guest data to Klaviyo profiles:

• Email
• Phone number
• First name
• Last name
• Street
• City
• State
• Zip
• Country
• Cloudbeds Guest ID
• Cloudbeds Gender
• Cloudbeds Birthday
• Cloudbeds Company Name
• Cloudbeds Special Requests
• Cloudbeds Main Guest
• Cloudbeds Custom Fields
• Cloudbeds Date Created
• Email consent
  Synced for guests who opted in to email marketing in Cloudbeds when you enable Sync your Cloudbeds email subscribers to Klaviyo and select a list. Turning off a guest’s email opt-in in Cloudbeds does not unsubscribe them in Klaviyo.

Please note that SMS consent is not synced from Cloudbeds.

Additional resources