curl --request POST \
  --url https://app.eat-now.io/api/partner/v1/reservations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "customer": {
    "name": "Jane Doe",
    "email": "jane@example.com",
    "phone_number": "+33612345678",
    "lang": "FR"
  },
  "party_size": 4,
  "start_at": "2026-04-08T19:15:00+01:00",
  "shift_id": "shift_dinner",
  "external_id": "partner-booking-123",
  "source": "WEBSITE",
  "tags": [
    "vip"
  ],
  "allergies": "Peanuts",
  "custom_message": "Seat near the window",
  "total_amount_paid": 12000,
  "bypass_payments": false,
  "bypass_availability": false,
  "bypass_approval": false,
  "send_client_notifications": true,
  "send_payment_link": true
}
'

{
  "data": {
    "id": "<string>",
    "external_id": "<string>",
    "start_at": "2023-11-07T05:31:56Z",
    "party_size": 2,
    "created_at": "2023-11-07T05:31:56Z",
    "updated_at": "2023-11-07T05:31:56Z",
    "customer": {
      "id": "<string>",
      "name": "<string>",
      "email": "jsmith@example.com",
      "phone_number": "<string>"
    },
    "room": {
      "id": "<string>",
      "name": "<string>"
    },
    "tables": [
      {
        "id": "<string>",
        "name": "<string>",
        "min_pax": 123,
        "max_pax": 123
      }
    ],
    "waiter": {
      "id": "<string>",
      "name": "<string>"
    },
    "shift": {
      "id": "<string>",
      "name": "<string>",
      "start_time": "<string>",
      "end_time": "<string>"
    },
    "discount": {
      "id": "<string>",
      "value": 123,
      "message": "<string>"
    },
    "prescriber": {
      "id": "<string>",
      "name": "<string>",
      "phone_number": "<string>"
    },
    "custom_message": "<string>",
    "allergies": "<string>",
    "metadata": {},
    "feedback": {
      "rating": 123,
      "comment": "<string>",
      "answer": "<string>",
      "created_at": "2023-11-07T05:31:56Z",
      "answered_at": "2023-11-07T05:31:56Z"
    },
    "cancellation_reason": "<string>",
    "attached_files": [
      "<string>"
    ],
    "tags": [
      "<string>"
    ],
    "send_followup_email": true,
    "is_table_definitive": true,
    "is_force_inserted": true,
    "total_amount_paid": 123,
    "payment_summary": {
      "total_amount": 123,
      "paid_amount": 123,
      "authorized_amount": 123,
      "pending_amount": 123,
      "refunded_amount": 123,
      "statuses": []
    },
    "payments": [
      {
        "id": "<string>",
        "provider_id": "<string>",
        "amount": 123,
        "quantity": 123,
        "unit_price": 123,
        "percent_of_total": 123,
        "is_refundable": true,
        "expiration_date": "2023-11-07T05:31:56Z",
        "max_cancellation_date": "2023-11-07T05:31:56Z",
        "authorized_at": "2023-11-07T05:31:56Z",
        "capture_deadline": "2023-11-07T05:31:56Z",
        "captured_at": "2023-11-07T05:31:56Z",
        "voided_at": "2023-11-07T05:31:56Z",
        "linked_product": {
          "id": "<string>",
          "name": "<string>"
        },
        "linked_variant": {
          "id": "<string>",
          "name": "<string>"
        },
        "created_at": "2023-11-07T05:31:56Z",
        "updated_at": "2023-11-07T05:31:56Z"
      }
    ],
    "seated_at": "2023-11-07T05:31:56Z",
    "left_at": "2023-11-07T05:31:56Z",
    "sensitive_data_included": true
  }
}

{
  "error": {
    "message": "<string>",
    "request_id": "<string>",
    "details": {}
  }
}

{
  "error": {
    "message": "<string>",
    "request_id": "<string>",
    "details": {}
  }
}

{
  "error": {
    "message": "<string>",
    "request_id": "<string>",
    "details": {}
  }
}

{
  "error": {
    "code": "RESOURCE_CONFLICT",
    "message": "external_id must be unique per restaurant and is already in use",
    "request_id": "7d8e6350-b815-4ac9-bfc3-57c6d2e7d8fa"
  }
}

{
  "error": {
    "message": "<string>",
    "request_id": "<string>",
    "details": {}
  }
}

Reservations

Create a reservation

Creates a reservation using the same booking side effects as the standard booking flow. Partner v1 create supports deposit inference only. Explicit prepayment or extra-product selection is not supported. external_id, when provided, must be unique per restaurant and duplicate values return a conflict response. customer may be set to null to create an anonymous reservation with no linked customer, such as a walk-in. bypass_availability is available only to credentials with the RESERVATIONS_FORCE_INSERT scope and force-inserts the reservation without capacity validation. The same RESERVATIONS_FORCE_INSERT scope is also required when initial_status is provided to override the normal create-time status derivation for trusted operational integrations such as POS walk-ins. bypass_approval is available only to credentials with the RESERVATIONS_FORCE_CONFIRM scope and bypasses manual staff approval for shifts that would normally create pending reservations.

POST

api

partner

reservations

curl --request POST \
  --url https://app.eat-now.io/api/partner/v1/reservations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "customer": {
    "name": "Jane Doe",
    "email": "jane@example.com",
    "phone_number": "+33612345678",
    "lang": "FR"
  },
  "party_size": 4,
  "start_at": "2026-04-08T19:15:00+01:00",
  "shift_id": "shift_dinner",
  "external_id": "partner-booking-123",
  "source": "WEBSITE",
  "tags": [
    "vip"
  ],
  "allergies": "Peanuts",
  "custom_message": "Seat near the window",
  "total_amount_paid": 12000,
  "bypass_payments": false,
  "bypass_availability": false,
  "bypass_approval": false,
  "send_client_notifications": true,
  "send_payment_link": true
}
'

{
  "data": {
    "id": "<string>",
    "external_id": "<string>",
    "start_at": "2023-11-07T05:31:56Z",
    "party_size": 2,
    "created_at": "2023-11-07T05:31:56Z",
    "updated_at": "2023-11-07T05:31:56Z",
    "customer": {
      "id": "<string>",
      "name": "<string>",
      "email": "jsmith@example.com",
      "phone_number": "<string>"
    },
    "room": {
      "id": "<string>",
      "name": "<string>"
    },
    "tables": [
      {
        "id": "<string>",
        "name": "<string>",
        "min_pax": 123,
        "max_pax": 123
      }
    ],
    "waiter": {
      "id": "<string>",
      "name": "<string>"
    },
    "shift": {
      "id": "<string>",
      "name": "<string>",
      "start_time": "<string>",
      "end_time": "<string>"
    },
    "discount": {
      "id": "<string>",
      "value": 123,
      "message": "<string>"
    },
    "prescriber": {
      "id": "<string>",
      "name": "<string>",
      "phone_number": "<string>"
    },
    "custom_message": "<string>",
    "allergies": "<string>",
    "metadata": {},
    "feedback": {
      "rating": 123,
      "comment": "<string>",
      "answer": "<string>",
      "created_at": "2023-11-07T05:31:56Z",
      "answered_at": "2023-11-07T05:31:56Z"
    },
    "cancellation_reason": "<string>",
    "attached_files": [
      "<string>"
    ],
    "tags": [
      "<string>"
    ],
    "send_followup_email": true,
    "is_table_definitive": true,
    "is_force_inserted": true,
    "total_amount_paid": 123,
    "payment_summary": {
      "total_amount": 123,
      "paid_amount": 123,
      "authorized_amount": 123,
      "pending_amount": 123,
      "refunded_amount": 123,
      "statuses": []
    },
    "payments": [
      {
        "id": "<string>",
        "provider_id": "<string>",
        "amount": 123,
        "quantity": 123,
        "unit_price": 123,
        "percent_of_total": 123,
        "is_refundable": true,
        "expiration_date": "2023-11-07T05:31:56Z",
        "max_cancellation_date": "2023-11-07T05:31:56Z",
        "authorized_at": "2023-11-07T05:31:56Z",
        "capture_deadline": "2023-11-07T05:31:56Z",
        "captured_at": "2023-11-07T05:31:56Z",
        "voided_at": "2023-11-07T05:31:56Z",
        "linked_product": {
          "id": "<string>",
          "name": "<string>"
        },
        "linked_variant": {
          "id": "<string>",
          "name": "<string>"
        },
        "created_at": "2023-11-07T05:31:56Z",
        "updated_at": "2023-11-07T05:31:56Z"
      }
    ],
    "seated_at": "2023-11-07T05:31:56Z",
    "left_at": "2023-11-07T05:31:56Z",
    "sensitive_data_included": true
  }
}

{
  "error": {
    "message": "<string>",
    "request_id": "<string>",
    "details": {}
  }
}

{
  "error": {
    "message": "<string>",
    "request_id": "<string>",
    "details": {}
  }
}

{
  "error": {
    "message": "<string>",
    "request_id": "<string>",
    "details": {}
  }
}

{
  "error": {
    "code": "RESOURCE_CONFLICT",
    "message": "external_id must be unique per restaurant and is already in use",
    "request_id": "7d8e6350-b815-4ac9-bfc3-57c6d2e7d8fa"
  }
}

{
  "error": {
    "message": "<string>",
    "request_id": "<string>",
    "details": {}
  }
}

Authorizations

Authorization

string

header

default:your_token_here

required

Restaurant-scoped partner API token passed as Authorization: Bearer <token>.

Body

application/json

Reservation creation payload for standard bookings, force inserts, or operational walk-ins.

customer

object | null

required

Customer payload for the reservation. Use null to create an anonymous reservation with no linked customer, such as a walk-in.

Show child attributes

party_size

integer

required

Required range: x >= 1

start_at

string<date-time>

required

Reservation start datetime in the restaurant timezone, including offset.

shift_id

string

Optional shift identifier. When omitted, the system resolves the shift from start_at.

Minimum string length: 1

room_id

string

Optional room identifier to target during booking.

Minimum string length: 1

table_ids

string[]

Optional table identifiers to assign at creation.

Minimum string length: 1

waiter_id

string

Minimum string length: 1

external_id

string

Optional partner reference. When provided, it must be unique per restaurant.

Minimum string length: 1

source

enum<string>

Optional reservation source. Defaults to WEBSITE.

Available options:

WALK_IN,

WEBSITE,

PHONE,

EMAIL,

RESERVE_WITH_GOOGLE,

TRAVEL_AGENCIES,

OTHER,

INSTAGRAM,

FACEBOOK,

TIKTOK,

SNAPCHAT,

WHATSAPP,

TRIPADVISOR,

PRIVATIZATION,

MISSED_CALL

prescriber_id

string

Minimum string length: 1

discount_id

string

Minimum string length: 1

Response

Reservation created

data

object

required

Show child attributes

Search reservations Get a reservation

Overview

Meta

Authentication

Catalog

Availability

Reservations

Missed Calls

Create a reservation

Authorizations

Body

Response