Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Code Block
POST v3/requests


Request URL Parameters

ParameterDescription

hotel_id
integer
required


Property Numerical identifier 
Cannot be null

Guest
array of strings
required


see list of supported strings
Category
string
required

form category name from the categories endpoint
room
string
optional

Guest room for their booking
booking_id
string
optional

The reservation identifier for the guests stay with the property, if applicable.
guest_notify
boolean
required

Should an email be sent to the guest notifying them of this requests creation?  Recommended false
staff_username
string
optional


Staff Username from the staff endpoint if provided the newly created request will be assigned to this staffer.

status
string
optional


Request status may managed by the api
supported strings "New, Assigned, Processing, Completed, Cancelled"

form_name
string
required

Name of the form we are creating this request for from the forms endpoint
form_fields
array
required

details of the form request.  Needs to match any required form_fields for the specified form_name from the forms forms endpoint

Example Request

Code Block
{
  "hotel_id": 2,
  "room": "32",
  "booking_id": "1332025-4X",
  "guest": {
    "email": "joeb@banks.com",
    "name": "Joe Banks",
    "phone": "7075551414"
  },
  "guest_notify": false,
  "form_category": "Treatment",
  "form_name": "Spa Menu",
  "form_fields": {
  	"Notes": "We'd like hot towels and a room to meditate in",
	"swedish1": 2,
    "pregnancy2": 1
  }
}

...