Documentation

MutationsSandbox API

createProperty mutation

Creates a property in the sandbox environment. If you do not provide input arguments, the property is created with logical test data.

Syntax

1mutation {
2  createProperty(input: CreatePropertyInput!): CreatePropertyPayload!
3}

Example

Request - Without args
Request - With args
Response

1mutation { 
2  createProperty(input: {}) { 
3    property { 
4      id 
5      name 
6    } 
7  } 
8}

Arguments

Name	Description
`input`	Required. Type: CreatePropertyInput

Types

Name

Type

Boolean

The Boolean scalar type represents true or false.

BusinessModel

Enum

Entity that collects payment for the reservation.

Name	Description
`EXPEDIA_COLLECT`	Expedia collects payment for the reservation.
`HOTEL_COLLECT`	Partner collects payment for the reservation.

CreatePropertyInput

InputObject

Input object for creating a property.

Field	Description
`clientMutationId`	Partner's transaction ID that uniquely identifies the request, which can be used to associate requests and responses for troubleshooting purposes. This ID must be unique across requests and cannot be reused. However, if a request needs to be retried, such as because it failed or timed out, the ID provided in the original request should be used. The ID can be in any format as long as it uniquely identifies the request. Type: String
`name`	Name for the property. Type: String
`supplierUnitId`	Supplier's unit ID for the property. Type: String

CreatePropertyPayload

Object

Response payload to the createProperty mutation.

Field	Description
`clientMutationId`	Partner's transaction ID that identifies the request, which can be used to correlate with partner's transaction logs. This ID must be unique across requests and cannot be reused. Type: String
`property`	Not nullable. Property details for the property that was created. Type: Property

Date

Scalar that represents a date string compliant with the RFC 3339 profile of the ISO 8601 standard.

Float

The Float scalar type represents signed double-precision fractional values as specified by IEEE 754.

Guest

Object

Details about the guest who made the reservation.

Field	Description
`emailAddress`	Not nullable. Email address of the guest. Type: String
`firstName`	Not nullable. First (given) name of the guest. Type: String
`lastName`	Not nullable. Last name (surname) of the guest. Type: String
`loyaltyTier`	Not nullable. The traveler's Expedia Group VIP Access loyalty tier. Values include MEMBER, VIP, PREMIUMVIP, and null. Type: String
`phoneNumbers`	Not nullable. Phone numbers associated with the guest. Type: Array of non nullable GuestContactPhoneNumber
`supplierLoyaltyPlanInfo`	Details about the guest's frequent traveler reward program. Type: SupplierLoyaltyPlanInfo

GuestContactPhoneNumber

Object

Guest phone number.

Field	Description
`areaCode`	Not nullable. Area code (three digits). Type: String
`countryCode`	Not nullable. Country code (two digits). Type: String
`number`	Not nullable. Phone number (seven digits, no hyphen). Type: String

The ID scalar type represents a unique identifier, often used to refetch an object or as key for a cache. The ID type appears in a JSON response as a String; however, it is not intended to be human-readable. When expected as an input type, any string (such as "4") or integer (such as 4) input value will be accepted as an ID.

IdNode

Object

Known IDs in the source system.

Field	Description
`id`	Not nullable. ID in the source system. Type: String
`idSource`	Not nullable. Source of the ID. Type: IdSource

IdSource

Enum

Source of a given ID.

Name	Description
`EXPEDIA`	Expedia is the source of the ID.
`SUPPLIER`	Connectivity provider or lodging partner is the source of the ID.
`VRBO`	Unsupported.

Int

The Int scalar type represents non-fractional signed whole numeric values. Int can represent values between -(2^31) and 2^31 - 1.

Money

Object

Monetary amount along with its currency.

Field	Description
`amount`	Not nullable. Actual monetary amount value. The scale of the amount will vary according to the currency or any rate conversion that may have been applied. Type: String
`currencyCode`	Not nullable. Code of the currency of the amount. Type: String

Payment

Object

Guest payment details.

Field	Description
`cardNumber`	Not nullable. Card number. Sandbox value is always \"4111111111111111\". Type: String
`issuerName`	Not nullable. Name of the issuer associated with the card. Sandbox value is \"VISA\" for HOTEL_COLLECT reservations and \"MasterCard\" for EXPEDIA_COLLECT reservations. Type: String
`paymentInstrumentType`	Not nullable. Type of payment instrument. Sandbox value is \"GUEST_CREDIT_CARD\" for HOTEL_COLLECT reservations and \"EXPEDIA_VIRTUAL_CARD\" for EXPEDIA_COLLECT reservations. Type: String
`verificationNumber`	Randomly generated, three-digit verification number associated with the card. Type: String

Property

Object

Details about a property that was created in the sandbox.

Field	Description
`id`	Not nullable. ID of the property. Type: ID
`name`	Not nullable. Name of the property. Type: String
`reservations`	Not nullable. Reservation details for this sandbox property. `limit` argument: Specifies the number of results to return (default: 25). If you want to fetch more or less than 25 results, specify this argument. `cursor` argument: Specifies the value of the cursor of the last reservation in the current page; empty if no more results are available. Type: ReservationsResponse
`supplierUnitId`	Supplier's unit ID for the property. Type: String

ReconciliationType

Enum

Type of reconciliation that has been performed on the reservation.

Name	Description
`CANCEL`	Reservation was cancelled.
`MODIFY`	Reservation was modified.
`NO_SHOW`	Reservation was marked as a no-show.
`REFUND`	Reservation was refunded.

RemittanceType

Enum

Remittance type of the reservation.

Name	Description
`GROSS`	Gross remittance type.
`NET`	Net remittance type.

Reservation

Object

Reservation details.

Field	Description
`accessibilityText`	Not nullable. Accessibility requests made by the guest for the reservation. Type: Array of non nullable String
`adultCount`	Not nullable. Count for all adult guests associated with the reservation. Type: Int
`amounts`	Amounts associated with the reservation. Type: ReservationAmounts
`bedTypes`	Bed type of the reservation. Type: String
`businessModel`	Not nullable. Entity that collects payment for the reservation. Type: BusinessModel
`checkInDate`	Not nullable. Check-in date (format: YYYY-MM-DD) of the reservation. Type: Date
`checkOutDate`	Not nullable. Checkout date (format: YYYY-MM-DD) of the reservation. Type: Date
`childAges`	Ages of children associated with the reservation. Type: Array of non nullable Int
`childCount`	Not nullable. Count for all child guests associated with the reservation. Type: Int
`creationDateTime`	Not nullable. Date amd time when the reservation was created (format: yyyy-MM-dd'T'HH:mm:ss.SSSX, in UTC timezone). Type: String
`id`	Not nullable. Expedia ID of the reservation. Type: ID
`isReconciled`	Not nullable. Whether the reservation has been reconciled. Type: Boolean
`lastUpdatedDateTime`	Not nullable. Date and time when the reservation was last updated (format: yyyy-MM-dd'T'HH:mm:ss.SSSX, in UTC timezone). Type: String
`multiRoomText`	Text that is displayed to guests if there is a multi-room booking associated with the reservation. Type: String
`payment`	Not nullable. Payment details associated with the reservation. Type: Payment
`petCount`	Count of pets associated with the reservation. Type: Int
`primaryGuest`	Not nullable. Guest who made the reservation. Type: Guest
`propertyId`	Not nullable. Expedia ID for the property. Type: ID
`rateIds`	Unique identifiers for the rates associated with the reservation. Type: Array of non nullable IdNode
`reconciliationType`	Type of reconciliation that has been performed on the reservation, if any. Type: ReconciliationType
`remittanceType`	Remittance type of the reservation. Defaults to null. Type: RemittanceType
`reservationIds`	Not nullable. IDs for the reservation(s), each corresponding to a different source associated with the reservation. Type: Array of non nullable IdNode
`smokingType`	Not nullable. Whether smoking is allowed for the reservation. Type: String
`source`	Not nullable. Source of the reservation. Type: String
`specialRequest`	Text that is displayed to guests if there is a special request associated with the reservation. Type: String
`status`	Not nullable. Current status of the reservation. Type: ReservationStatus
`supplierOperatingModel`	Supplier's operating model. Type: SupplierOperatingModelType
`tidsCode`	Travel Industry Designator Service (TIDS) code that allows a reservation to be recognized by industry suppliers. Type: Int
`totalGuestCount`	Not nullable. Number of guests associated with the reservation. Type: Int
`unitIds`	Known IDs for the unit/room in the source system(s). IDs that are returned depend on where the property was onboarded: If the property was onboarded onto Vrbo, three IDs are returned: the partner's (external ID), Vrbo's (Vrbo internal ID), and Expedia's (EID). If the property was onboarded onto Expedia, only the Expedia ID is included in the response. Type: Array of non nullable IdNode
`valueAddedPromotions`	Value add promotion(s) used to book the reservation. Type: Array of non nullable ReservationValueAddedPromotion

ReservationAmounts

Object

Amounts associated with the reservation.

Field	Description
`nightlyPayments`	Detailed list of payments associated with the reservation. Type: ReservationNightlyPayments

ReservationDailyAmount

Object

Reservation amount that applies to a specific stay date.

Field	Description
`amount`	Not nullable. Amount value. Type: Money
`date`	Not nullable. Amount date (format: yyyy-MM-dd), such as 2025-01-30. Type: Date
`description`	Not nullable. Description associated to the amount. Type: String
`percent`	Percentage of amount (when applicable), expressed as a fraction of 1 (such as 0.12 for 12%). Type: Float
`type`	Not nullable. Amount type (BASE, DISCOUNT, TAX, GUESS_PAYMENT, PAYOUT, and so on). Type: String

ReservationNightlyPayments

Object

Nightly payments associated with the reservation.

Field	Description
`cancellationAmounts`	Not nullable. Cancellation amounts for the reservation. Type: Array of non nullable ReservationPerStayAmount
`dailyAmounts`	Not nullable. Reservation amounts for a specific stay date. Type: Array of non nullable ReservationDailyAmount
`perStayAmounts`	Not nullable. Reservation amounts that apply to the whole stay. Type: Array of non nullable ReservationPerStayAmount

ReservationPerStayAmount

Object

Reservation amount that applies to the whole stay.

Field	Description
`amount`	Not nullable. Amount value. Type: Money
`description`	Not nullable. Description associated to the amount. Type: String
`percent`	Percentage of amount (when applicable), expressed as a fraction of 1 (such as 0.12 for 12%). Type: Float
`type`	Not nullable. Amount type (BASE, DISCOUNT, TAX, GUESS_PAYMENT, PAYOUT, and so on). Type: String

ReservationsResponse

Object

Response object for reservations query.

Field	Description
`cursor`	Cursor for pagination. Type: String
`elements`	Not nullable. List of reservations. Type: Array of non nullable Reservation
`totalCount`	Not nullable. Total count of reservations. Type: Int

ReservationStatus

Enum

Current status of the reservation.

Name	Description
`BOOKED`	Reservation is booked and confirmed.
`CANCELLED`	Reservation is cancelled.

ReservationValueAddedPromotion

Object

Value add promotion(s) used to book the reservation.

Field	Description
`description`	Not nullable. Description of the value add promotion. Type: String
`id`	Not nullable. ID of the promotion. Type: String

String

The String scalar type represents textual data, represented as UTF-8 character sequences. The String type is most often used by GraphQL to represent free-form human-readable text.

SupplierLoyaltyPlanInfo

Object

Details about the frequent traveler reward program.

Field	Description
`membershipNumber`	Not nullable. Traveler's membership number. Type: Int
`planCode`	Not nullable. Reward program code. Type: String

SupplierOperatingModelType

Enum

Type of supplier operating model used for the reservation.

Name	Description
`AGENCY`	Partner operates on an agency model.
`MERCHANT`	Partner operates on a merchant model.

Availability and rates APIs

Booking APIs

Property mgmt APIs

Developer Tools

Sandbox API

createProperty mutation

Syntax

Example

Arguments

Types

Availability and rates APIs

Booking APIs

Property mgmt APIs

Developer Tools

Sandbox API

createProperty mutationCopy link

Syntax

Example

Arguments

Types

createProperty mutation