Roomability Guest API
Commerce & Guest API ServicesHotel Management System
Commerce & Guest API ServicesHotel Management System
  1. Reservations
Roomability Guest API
  • Admin
    • Authentication
      • Admin Profile
      • Login Admin
      • Admin Logout
      • Forget Password
      • Confirm Reset Password
    • Rooms
      • Get All Rooms
      • Get Room Details
      • Hide Rooms
      • Create Room
      • Update Room
      • Delete Room
    • Apartments
      • Get All Apartments
      • Get Apartment Details
      • Apartment Status
      • Create Apartment
      • Update Apartment
      • Delete Apartment
    • Proposals
      • Fetch All Proposals
      • Delete Proposals
      • Fetch Proposal Details
      • Approve / Decline Proposal
    • Reservations
      • All Reservation
        GET
      • Delete Reservations
        DELETE
      • End / Cancel Reservation
        PATCH
      • Add Reservation
        POST
      • Add Reservation (New)
        POST
      • Send Invoice
        POST
      • Change Reservation ID
        PUT
      • Filter For Reservations
        GET
      • Get Reservation Details
        GET
    • Bookings
      • All Booking Reservation
      • Delete Bookings
      • End / Cancel Reservation
      • Add Reservation (New)
      • Send Invoice
      • Change Reservation ID
      • Filter For Reservations
      • Get Booking Details
    • Receptionists
      • Create Receptionist
      • View All Receptionist
      • Delete Receptionist
    • Dashboard
      • Get Statistics
    • Schedule Calls
      • View All Schedules
      • Update Schedule Calls
    • Coupons
      • Create Coupon Code
      • Get All Coupon Code
      • Deactivate / Activate Coupon Code
      • Delete Coupon
    • Refunds
      • Get All Refunds
      • Issue a Refund
      • Approve Or Decline Refunds
      • Update Refunds
      • Filter Refund
    • Categories
      • Create Categories
      • Get All Room Types
      • Update Room Category
      • Delete Room Category
    • Payments (New)
      • Confirm Payment (New)
  • Users
    • Proposals
      • Send A Proposal
    • Reservations
      • Get All Reservations
      • Get Active Reservations
      • Extend Reservation
      • Download Invoice
      • Get Reservation Details
    • Authentication
      • User Registration
      • User Profile
      • Forget Password
      • User Login
      • User Logout
      • Update Account
      • Confirm Reset Password
      • Code Verification
    • Payments
      • Verify Payment
      • Payment For Reservation
      • Create Payment Link (New)
      • Confirm Payment (New)
      • Make Payment For Apartment
      • Verify Paid Apartments
    • Coupons
      • Apply Coupons
    • Refunds
      • Issue a Refund
      • Get All Refunds
  • Rooms
    • Get All Rooms
    • View Room Details
    • Filter Rooms
    • Get Avaliable Rooms
  • Apartments
    • Get All Apartments
    • View Apartment Details
    • Get Avaliable Apartments
  • Categories
    • Get All Categories
  • Owners
    • Authentication
      • Code Verification
      • Get Profile
      • Login
      • User Registration
      • Forget Password
      • Update Account Copy
  • Base Endpiont
    GET
  • Health Check
    GET
  • Schedule A Call
    POST
  • Subscribe Email
    POST
  • Cron Jobs
    GET
  • Payment Webhook
    POST
  • New Request
    GET
Commerce & Guest API ServicesHotel Management System
Commerce & Guest API ServicesHotel Management System
  1. Reservations

Add Reservation (New)

POST
/admin/reservations/create
Last modified:2026-03-12 17:03:01

Request

Authorization
Provide your bearer token in the
Authorization
header when making requests to protected resources.
Example:
Authorization: Bearer ********************
Body Params application/json

Examples

Responses

🟢201
application/json
Body

Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST '/admin/reservations/create' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "roomId": "string",
    "email": "string",
    "fullName": "string",
    "isPaid": true,
    "type": "string",
    "roomsTaken": 0,
    "freshBooking": true,
    "fromDate": "string",
    "toDate": "string",
    "validId": {
        "name": "string",
        "mimetype": "string",
        "buffer": "string"
    }
}'
Response Response Example
{
    "status": true,
    "message": "Success! Room reserved successfully.",
    "data": {
        "roomName": "Test 2 Asa Royal room",
        "userId": "654181a1b76f1c39de011d69",
        "fullName": "Abdullah Yahaya Abu",
        "invoice": "https://storage.googleapis.com/hotel-project-a01c4.appspot.com/invoice.pdf?GoogleAccessId=firebase-adminsdk-7wnwl%40hotel-project-a01c4.iam.gserviceaccount.com&Expires=1893452400&Signature=S42oYEUuyBEw8K4A0896OowE%2BRLzsWS6hDSoLH5yns4EmwSUlx1SL%2B9BFgO91M4aE9wvN48gvi9MNvKMtkbUPcxFeH%2FHlC4gtQuiFgshE4kL6FfPbuBjTiI7jBoq0PARxMvaLL5yplRXStvSGYuiVF0Ey8UEftxUy0oCtgzFPyNj4u8lRiI9MpADCZol2I7Ng33exVB29j1Oc5c0H4VCEMgiZzVldBNJ99PvgQFJT%2Fc%2FrZ3VsDVe9jY0CqicE1uoockbc8n2JroUR%2BSbB5lv2Ue2U5753aaS77mU9ewWJYpQjcHxxnuMihH0yr4c6U8HM2TpIh3t1JZZk58%2Fr3QJVQ%3D%3D",
        "roomId": "654181a1b76f1c39de011d69",
        "roomsTaken": 4,
        "reservationType": "Family Room",
        "status": "active",
        "nights": 2,
        "fromDate": "2023-11-08T00:00:00.000Z",
        "toDate": "2023-11-10T00:00:00.000Z",
        "location": "Akure",
        "_id": "654b14d0fa824da46440ed8b",
        "createdAt": "2023-11-08T04:55:44.608Z",
        "updatedAt": "2023-11-08T04:55:44.608Z",
        "__v": 0
    }
}
Modified at 2026-03-12 17:03:01
Previous
Add Reservation
Next
Send Invoice
Built with