Review Replies

Parameters

OAuth Scopes:

public

Name	Type	Read/Write	Description
id	UUID	Read	Review Reply id.
message	Text	Read	Reply to given Guest or Host review
submitted_at	Time	Read	Review Reply submission time.
created_at	Time	Read	Review's create time.
updated_at	Time	Read	Review's update time.

reviews_write

Name	Type	Read/Write	Description
id	UUID	Read	Review Reply id.
message	Text	Read/Write	Required Reply to given Guest or Host review
submitted_at	Time	Read/Write	Review Reply submission time. When not provided it will be set to creation time.
created_at	Time	Read	Review's create time.
updated_at	Time	Read	Review's update time.

List review replies

List all review replies for a given account(s).

GET /review_replies

OAuth Scopes:

public

response.json

{
  "links": {
    "review_replies.booking": "https://www.bookingsync.com/api/v3/bookings/{review_replies.booking}",
    "review_replies.host_review": "https://www.bookingsync.com/api/v3/rentals/{review_replies.host_review}",
    "review_replies.review": "https://www.bookingsync.com/api/v3/rentals/{review_replies.review}",
    "review_replies.account": "https://www.bookingsync.com/api/v3/rentals/{review_replies.account}"
  },
  "review_replies": [
    {
      "links": {
        "host_review": "96f9e3f1-ed2a-4c8c-8e2f-1d3e1d0c8356",
        "review": null,
        "booking": 4,
        "account": 1
      },
      "id": "c7bd77d3-0c74-4da8-8a64-5461f80ff81b",
      "reply": "Merci!",
      "replied_at": "2025-04-11T14:00:28.875Z",
      "created_at": "2025-04-11T14:00:28.875Z",
      "updated_at": "2025-04-18T14:00:28.875Z"
    }
  ]
}

Get a single review

Returns a single review identified by ID.

GET /review_replies/:review_id

OAuth Scopes:

public

response.json

{
  "links": {
    "review_replies.booking": "https://www.bookingsync.com/api/v3/bookings/{review_replies.booking}",
    "review_replies.host_review": "https://www.bookingsync.com/api/v3/rentals/{review_replies.host_review}",
    "review_replies.review": "https://www.bookingsync.com/api/v3/rentals/{review_replies.review}",
    "review_replies.account": "https://www.bookingsync.com/api/v3/rentals/{review_replies.account}"
  },
  "review_replies": [
    {
      "links": {
        "host_review": "96f9e3f1-ed2a-4c8c-8e2f-1d3e1d0c8356",
        "review": null,
        "booking": 4,
        "account": 1
      },
      "id": "c7bd77d3-0c74-4da8-8a64-5461f80ff81b",
      "reply": "Merci!",
      "replied_at": "2025-04-11T14:00:28.876Z",
      "created_at": "2025-04-11T14:00:28.876Z",
      "updated_at": "2025-04-18T14:00:28.876Z"
    }
  ]
}

Reply to guest or host review

As of now, every guest or host review may have only one reply.

Reply to guest review

Replies to a given guest review

POST /reviews/:review_id/reply

OAuth Scopes:

reviews_write

request.json

{
  "review_replies": [
    {
      "message": "Merci!"
    }
  ]
}

response.json

{
  "links": {
    "review_replies.booking": "https://www.bookingsync.com/api/v3/bookings/{review_replies.booking}",
    "review_replies.host_review": "https://www.bookingsync.com/api/v3/rentals/{review_replies.host_review}",
    "review_replies.review": "https://www.bookingsync.com/api/v3/rentals/{review_replies.review}",
    "review_replies.account": "https://www.bookingsync.com/api/v3/rentals/{review_replies.account}"
  },
  "review_replies": [
    {
      "links": {
        "host_review": null,
        "review": 14,
        "booking": 4,
        "account": 1
      },
      "id": "c7bd77d3-0c74-4da8-8a64-5461f80ff81b",
      "reply": "Merci!",
      "replied_at": "2025-04-11T14:00:28.878Z",
      "created_at": "2025-04-11T14:00:28.878Z",
      "updated_at": "2025-04-18T14:00:28.878Z"
    }
  ]
}

Reply to host review

Replies to a given host review

POST /host_reviews/:host_review_id/reply

OAuth Scopes:

reviews_write

request.json

{
  "review_replies": [
    {
      "message": "Merci!"
    }
  ]
}

response.json

{
  "links": {
    "review_replies.booking": "https://www.bookingsync.com/api/v3/bookings/{review_replies.booking}",
    "review_replies.host_review": "https://www.bookingsync.com/api/v3/rentals/{review_replies.host_review}",
    "review_replies.review": "https://www.bookingsync.com/api/v3/rentals/{review_replies.review}",
    "review_replies.account": "https://www.bookingsync.com/api/v3/rentals/{review_replies.account}"
  },
  "review_replies": [
    {
      "links": {
        "host_review": "96f9e3f1-ed2a-4c8c-8e2f-1d3e1d0c8356",
        "review": null,
        "booking": 4,
        "account": 1
      },
      "id": "c7bd77d3-0c74-4da8-8a64-5461f80ff81b",
      "reply": "Merci!",
      "replied_at": "2025-04-11T14:00:28.879Z",
      "created_at": "2025-04-11T14:00:28.879Z",
      "updated_at": "2025-04-18T14:00:28.879Z"
    }
  ]
}