# Create Booking

This endpoint allows Mozrest to create a new booking in the partner's system. The request includes necessary details such as venue, party size, date, and contact information to ensure proper reservation creation.

## Endpoint

`POST https://partner-domain.com/v1/mozrest/booking`

## Body Parameters

| Parameter | Status | Description |
|  --- | --- | --- |
| venueId | **Mandatory** | The unique Venue ID as defined in the Partner's system. |
| bookingChannel.id | **Mandatory** | Booking channel id where the customer placed the booking |
| bookingChannel.name | **Mandatory** | Booking channel name where the customer placed the booking |
| partySize | **Mandatory** | Number of people for the reservation (e.g., **4**). |
| date | **Mandatory** | Date and time of the booking in ISO 8601 format. |
| areaId | **Optional** | The unique Area ID for location within the venue if applicable. |
| contact.firstname | **Mandatory** | First name of the contact person making the booking. |
| contact.lastname | **Mandatory** | Last name of the contact person making the booking. |
| contact.email | **Mandatory** | Email address of the contact person. |
| contact.telephone | **Mandatory** | Phone number of the contact person. |
| contact.locale | **Optional** | Preferred language/locale of the contact person. |
| notes | **Optional** | Special instructions or requests associated with the booking. |
| paymentToken | **Optional** | Payment gateway token if prepayment is required. |


## Example Request


```json
curl POST "https://partner-domain.com/v1/mozrest/booking" \
  -H "Authorization: Bearer {{api_key}}" \ 
  --data-raw '{
        "venueId": "60e890aca5f07b6ee5b950b1",
        "bookingChannel": {
          "id": "60e890aca5f07b6ee5b950b3",
          "name": "Channel Name"
        },  
        "partySize": 4,
        "areaId": "60e5a3ed409541da3650b2d3",
        "date": 1639578600,
        "notes": "I am allergic to peanuts",
        "contact": {
            "firstname": "John",
            "lastname": "Doe",
            "email": "john.doe@gmail.com",
            "telephone": "44344223322",
            "locale": "en",
            },
            "optInConsent": true
        },
        "paymentGatewayToken": "pm_1JkkRzAY52ufXkvaHWKbasua",
    }'
```

## Example Response


```json
{
  "id": "60e890aca5f07b6ee5b950b1",
  "status": "pending_confirmation"
}
```

## Response Definitions

- **id**: Unique identifier for the booking.
- **status**: Status of the booking (e.g., "confirmed").


## Booking statuses allowed

| Parameter | Description |
|  --- | --- |
| confirmed | Booking is confirmed |
| pending_confirmation | Booking requires manually approval by de venue |
| requires_payment | Booking requires payment |