GUguesty
Views

Create a view

Changed on

Create a saved view for a section. title and section are both required. The new view is owned by the authenticated user and scoped to their account. Returns the created view. Use 'Update view' to set fields and filters.

post/views

Request

  • Base URL
    https://open-api.guesty.com/v1
  • URL
    https://open-api.guesty.com/v1/views
  • Auth
    API key in header authorization

Request body

titlestring required

Title for the view.

sectionstring required

one of: listings or reservations

Example request

{
  "title": "Example Listing",
  "section": "listings"
}

Response

View

_idstring

Unique id

accountIdstring

Id of the user owning this view

titlestring

Title for the view

fieldsstring

Selection of fields, separated by space

sortstring

ascending sort, use '-' for descending sort

createdAtstring date-time

Timestamp when the view was created.

updatedAtstring date-time

Timestamp when the view was last updated.

Example response

{
  "scheduledEmails": [
    {
      "days": [
        4
      ],
      "hour": 14
    }
  ],
  "shares": [
    {
      "contactId": "5926bdfb1bfe871000d0a745"
    }
  ]
}

Changes