Atlas Open API
  1. Incoming
Atlas Open API
  • Introduction
  • Authentication
  • Date and Time
  • Errors
  • Webhooks
    • Incoming
      • Reservations (BETA)
        POST
    • Outgoing
      • Menus, Stocks, Orders, Outlets, Users
  • Menus
    • Menu List
      GET
    • Menu Details
      GET
    • Menu Create or Update
      POST
  • Orders
    • Create Order
      POST
    • Order Details
      GET
    • Update Order
      PATCH
  • Stocks
    • Outlet Stocks
      GET
  • Users
    • User Sync
      POST
  • Tables
    • Tables
      GET
  • Carts
    • Untitled Endpoint
      POST
  1. Incoming

Reservations (BETA)

POST
/webhooks/reservations
The API can be accessed with the base URL below:
// Production
https://api.atlas.kitchen/v1/restaurants

// Development
https://api-dev.atlas.kitchen/v1/restaurants

Sends data from external apps into Atlas.
Based on the supplied data, Atlas will either create or update a reservation.
If reservation_id already exists, it will update the reservation.
If not, it will create a new reservation with the reservation_id.

Request

Header Params

Body Params application/json

Example
{
    "event_type": "reservations.create",
    "event_payload": {
        "reservation_id": "ORTIXZRIJBEP",
        "reservation_datetime": "2025-03-14T11:00:00.000Z",
        "confirmed_at": "2025-03-07T10:51:28.228Z",
        "diner_name": "Jum T",
        "diner_email": "jum@atlas.kitchen",
        "diner_mobile_number": "+6587286354",
        "pax": 2,
        "tables": [
            "T1",
            "T2"
        ],
        "area": "Main dining",
        "reservation_notes": "Selected: Counter Top Seating",
        "reservation_tags": "Birthday",
        "deposit_fractional": 5000,
        "status": "confirmed",
        "reservation_source": "Phone"
    }
}

Request Code Samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST '/webhooks/reservations' \
--header 'X-Api-Key: {{reservation_api_key}}' \
--header 'X-Outlet-Id: 1' \
--header 'X-Platform: Chope' \
--header 'X-Merchant-ID: atlas-merchant-id-1' \
--header 'Content-Type: application/json' \
--data-raw '{
    "event_type": "reservations.create",
    "event_payload": {
        "reservation_id": "ORTIXZRIJBEP",
        "reservation_datetime": "2025-03-14T11:00:00.000Z",
        "confirmed_at": "2025-03-07T10:51:28.228Z",
        "diner_name": "Jum T",
        "diner_email": "jum@atlas.kitchen",
        "diner_mobile_number": "+6587286354",
        "pax": 2,
        "tables": [
            "T1",
            "T2"
        ],
        "area": "Main dining",
        "reservation_notes": "Selected: Counter Top Seating",
        "reservation_tags": "Birthday",
        "deposit_fractional": 5000,
        "status": "confirmed",
        "reservation_source": "Phone"
    }
}'

Responses

🟢200Success
This response does not have a body.
🟠401Unauthorized
🟠422Invalid Parameter
Modified at 2025-07-31 09:40:01
Previous
Errors
Next
Menus, Stocks, Orders, Outlets, Users
Built with