# POST /crm/reservations/slots

Section: [CRM · Reservations](https://appengine.appmint.io/documentation/tag/crm-reservations.md) · Full index: https://appengine.appmint.io/documentation.md
## POST /crm/reservations/slots

**Generate appointment slots**

`operationId: ReservationsController_generateAppointmentSlots`

Computes the bookable slots for a period from the service point's availability and existing reservations.

Slots are calculated, not reserved — one returned here can be taken by someone else before you book it.

The definition record must be datatype **`reservation_definition`**. Creating it as `crm_reservation_definition` succeeds and then every slot request answers "Reservation Definition not found", because the generator looks in the other collection.

Slot times come back in UTC with `businessTimezone` alongside. Format for display in the business timezone, not the visitor's — a customer abroad shown their own local time books an appointment nobody turns up to.

#### Signature

```http
POST /crm/reservations/slots (body) -> An object containing the selected reservationDefinition and service, and a slots array. Closed or inactive definitions return an empty slots array with an explanatory flag.
```

#### Access

Public — no credentials required.

#### Notes

- No hold is placed. Handle the race between showing a slot and booking it.

#### Errors

Plus the standard platform errors: `429`, `500`.

#### See also

- `POST /crm/reservations/create`

### Parameters

| Name | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `orgid` | header | string | yes | Organization (tenant) identifier. Every request is scoped to this org; data from other orgs is never visible. Issued with your API credentials. |

### Request body

The criteria to generate slots for.

```json
{
  "reservationDefinitionId": "6acb4561d685f653775b8772",
  "serviceName": "Room planning",
  "serviceDate": "2026-10-22"
}
```

### Responses

| Status | Meaning |
| --- | --- |
| `201` | An object containing the selected reservationDefinition and service, and a slots array. Closed or inactive definitions return an empty slots array with an explanatory flag. |
| `429` | Too Many Requests — More than 100,000 requests from one IP within 5 minutes (configurable per deployment). CORS preflights and requests from inside the platform cluster are not counted. The limiter answers before the error filter, so the body is `{ statusCode, error, message }` with no `path`, `method` or `timeStamp`; the `RateLimit-*` response headers say when the window resets. |
| `500` | An unexpected error occurred. Our team has been notified. — An unhandled server-side failure. |

