Create or update reservations | PriceLabs

curl -X POST https://api.pricelabs.co/v1/create_reservations \
     -H "X-API-Key: {{API_KEY}}" \
     -H "Content-Type: application/json" \
     -d '{
  "reservations": [
    {
      "listing_id": "12345",
      "pms_name": "airbnb",
      "reservation_id": "RES-001",
      "start_date": "2026-10-10",
      "end_date": "2026-10-13",
      "no_of_days": 3,
      "total_cost": 500,
      "currency": "USD",
      "booked_time": "2026-09-01",
      "pl_status": "booked",
      "cancelled_time": null,
      "total_fees": null,
      "total_taxes": null,
      "rental_revenue": null,
      "ota_commission": null,
      "host_payout": null,
      "booking_source": "airbnb",
      "guest_count": 2,
      "guest_zipcode": null
    }
  ]
}'

{
  "success": true,
  "total": 1,
  "success_count": 1,
  "failure_count": 0,
  "reservations": [
    {
      "reservation": {
        "listing_id": "12345",
        "pms_name": "airbnb",
        "reservation_id": "RES-001",
        "start_date": "2026-10-10",
        "end_date": "2026-10-13",
        "no_of_days": 3,
        "total_cost": "500",
        "currency": "USD",
        "booked_time": "2026-09-01",
        "pl_status": "booked",
        "cancelled_time": null,
        "total_fees": null,
        "total_taxes": null,
        "rental_revenue": null,
        "ota_commission": null,
        "host_payout": null,
        "booking_source": "airbnb",
        "guest_count": 2,
        "guest_zipcode": null
      },
      "success": true
    }
  ]
}

Creates or updates reservations in PriceLabs for listings in your account.

Use this when you need to add bookings that are not synced from a PMS — for example direct bookings, offline stays, or booked times corrections. Each request accepts a reservations array of 1–100 reservation objects. The API validates and processes objects independently, so one invalid reservation does not block the rest of the batch.

All 19 fields required. Every reservation object must include all fields below (use null for inapplicable values). Extra unknown fields are rejected for that row.

Field	Type	Notes
`listing_id`	string	Must exist for user’s account
`pms_name`	string	Must be a portfolio-analytics-enabled PMS
`reservation_id`	string/null	Auto-generated as `{listing_id}_{start_date}_{end_date}` if null. Has to be unique for a PMS
`start_date`	string	YYYY-MM-DD
`end_date`	string	YYYY-MM-DD, must be after `start_date`
`no_of_days`	number/null	Auto-computed from dates if null
`total_cost`	number/null	Required (>0) when `pl_status=booked`
`currency`	string	e.g. USD, EUR
`booked_time`	string/null	Required when `pl_status=booked`, must be ≤ `start_date`
`pl_status`	string	`booked`, `cancelled`, `blocked`, or `available`
`cancelled_time`	string/null	Required when `pl_status=cancelled`
`total_fees`	number/null
`total_taxes`	number/null
`rental_revenue`	number/null
`ota_commission`	number/null
`host_payout`	number/null
`booking_source`	string/null	`airbnb`, `vrbo`, `bcom`, `manual`, `others`
`guest_count`	number/null
`guest_zipcode`	string/null

Updates. A unique reservation is identified by reservation_id + pms_name.

Reservations previously created or updated via this API (or CSV upload) can be updated.
Reservations already synced from a PMS fetch cannot be overwritten (reservation already fetched via …).
Reservation IDs must be unique for a PMS.

Reservations can only be added for PMS/channels that support Portfolio Analytics. The listing must belong to the authenticated account. Team-member API keys need write permission on every listing in the payload.

Created reservations are available from GET /v1/reservation_data.

Request

This endpoint expects an object.

reservationslist of objectsRequired

Reservation rows to create or update. Maximum 100 per request.

Response

All reservations in the batch were created or updated.

successboolean

true when at least one reservation succeeded. false when every row failed.

totalinteger

Number of reservation objects in the request.

success_countinteger

Number of rows that were created or updated.

failure_countinteger

Number of rows that failed validation or could not be saved.

reservationslist of objects

Per-row results in the same order as the request.

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

500

Internal Server Error

Headers

Request

Response

Errors