# Découverte avec Samuel with Samuel Braniste

> 20 minutes pour comprendre - vos enjeux Business - votre utilisation de l'IA - Vos systèmes de productivités Et je vous donne mes 1ère recommandations. Sam.

- Host: Samuel Braniste
- Duration: 20 min
- Location: Google Meet
- Host time zone: Europe/Paris
- Confirmation: Bookings are confirmed instantly.
- Booking page: https://cal.com/samuel-braniste-gw1pfo/15min
- Event type id: 4197780

## Check availability

```http
GET https://api.cal.com/v2/slots?eventTypeId=4197780&start=YYYY-MM-DD&end=YYYY-MM-DD&timeZone=<IANA time zone>
cal-api-version: 2024-09-04
```

The response is `{"data":{"YYYY-MM-DD":[{"start":"<ISO 8601 with offset>"}]}}`; no API key is needed.

## Book

```http
POST https://api.cal.com/v2/bookings
cal-api-version: 2026-02-25
Content-Type: application/json

{
  "eventTypeId": 4197780,
  "start": "<UTC ISO 8601 start from the slots response>",
  "attendee": {
    "name": "…",
    "email": "…",
    "timeZone": "<IANA time zone>"
  },
  "guests": [
    "guest@example.com"
  ],
  "bookingFieldsResponses": {
    "notes": "…"
  }
}
```

- Required fields: `name` (Your name), `email` (Email address)
- Optional fields: `notes` (Additional notes), `guests` (Add guests)
- `name` and `email` go in `attendee` and `guests` is a list of emails; every other field goes in `bookingFieldsResponses` under its name.