RoomzaHelp Center

The reservations API

Push reservations automatically instead of uploading files, using your ingest key.

If you or a technical partner want reservations flowing automatically, skip the manual uploads and push them.

Setup, once

  1. Upload one export at Settings, then Import, and map its columns in the wizard.
  2. Save the mapping. Roomza issues your hotel an ingest API key and remembers the mapping, so pushed data is interpreted exactly like your uploads.

Pushing reservations

Send a POST request to your hotel's ingest endpoint with the key as a bearer token:

POST /api/hotels/{hotelId}/ingest
Authorization: Bearer {your ingest key}
Content-Type: application/json

{ "csvContent": "...your export, as CSV text..." }

The response reports how many reservations were created, how many duplicates were skipped, and how many rooms were auto-created from new room numbers.

Behavior guarantees

  • Idempotent: pushing overlapping data never creates duplicates.
  • Order-independent: unknown room numbers create their rooms on the fly.
  • Same pipeline: pushed reservations power verified reviews and review requests exactly like uploaded ones.

Questions or a PMS you'd like us to talk to directly? support@roomza.com.

Related

Import reservationsBring in your PMS export so Roomza can verify guests and ask them for reviews.AI discovery and your hotel's live data feedHow AI assistants read your property, and how to connect your data to your own tools.

Still stuck? Email support@roomza.com.