# booking.pending

Source: https://developer.nylas.com/docs/reference/notifications/scheduler/booking-pending/

Sent when a guest schedules a pending booking that requires confirmation.

**Recommended action:** Notify the host that a booking needs confirmation. Provide the `host_confirmation_url` so they can accept or reject.

## data.object fields

- `configuration_id` (string) **(required)** - The Scheduler configuration used to create this booking.
- `booking_id` (string) **(required)** - Unique identifier for the booking.
- `booking_ref` (string) - A human-readable booking reference string.
- `booking_type` (string) **(required)** (organizer-confirmation) - The confirmation type for this booking.
- `booking_info` (object) **(required)** - Details about the pending booking.
  - `event_id` (string) - The calendar event ID created for this booking.
  - `start_time` (integer) - Unix timestamp for the event start.
  - `end_time` (integer) - Unix timestamp for the event end.
  - `participants` (array, nullable) - List of booking participants. May be `null` when no participants are set.
    - `email` (string) - Participant email address.
    - `name` (string) - Participant display name.
  - `additional_fields` (object, nullable) - Custom fields collected from the guest during booking. May be `null` if no custom fields were provided.
  - `hide_cancellation_options` (boolean) - Whether cancellation options are hidden from the guest.
  - `hide_rescheduling_options` (boolean) - Whether rescheduling options are hidden from the guest.
  - `participant_rescheduling_url` (string) - URL the guest can use to reschedule the booking.
  - `participant_cancellation_url` (string) - URL the guest can use to cancel the booking.
  - `host_language` (string) - Locale code for the host's language.
  - `guest_language` (string) - Locale code for the guest's language.
  - `title` (string) - Title of the booked event.
  - `duration` (integer) - Event duration in minutes.
  - `location` (string) - Meeting location or conferencing link.
  - `organizer_timezone` (string) - IANA timezone of the organizer.
  - `guest_timezone` (string) - IANA timezone of the guest.
  - `is_group_event` (boolean) - Whether this is a group event with multiple attendees.
  - `organizer_calendar_id` (string) - Calendar ID where the event was created.
  - `event_description` (string) - Description text of the calendar event.
  - `event_html_link` (string) - Link to view the event in the provider's calendar UI.
  - `ical_uid` (string) - The iCalendar UID of the event.
  - `host_confirmation_url` (string) - URL for the host to confirm a pending booking. Only present for bookings that require host confirmation.
  - `notetaker_id` (string) - Notetaker bot ID if Notetaker is attached to this booking. Omitted when not applicable.

## Example payload

```json
{
  "specversion": "1.0",
  "type": "booking.pending",
  "source": "/nylas/passthru",
  "id": "<WEBHOOK_ID>",
  "time": 1725895310,
  "webhook_delivery_attempt": 1,
  "data": {
    "application_id": "<NYLAS_APPLICATION_ID>",
    "grant_id": "<NYLAS_GRANT_ID>",
    "object": {
      "configuration_id": "<CONFIGURATION_ID>",
      "booking_id": "<BOOKING_ID>",
      "booking_ref": "<BOOKING_REFERENCE>",
      "booking_type": "organizer-confirmation",
      "booking_info": {
        "event_id": "<EVENT_ID>",
        "start_time": 1719842400,
        "end_time": 1719846000,
        "participants": [
          {
            "email": "john.doe@example.com",
            "name": "John Doe"
          },
          {
            "email": "jane.smith@example.com",
            "name": "Jane Smith"
          }
        ],
        "additional_fields": {
          "phone": "+1-415-555-0199",
          "company": "Acme Corp"
        },
        "hide_cancellation_options": false,
        "hide_rescheduling_options": false,
        "participant_rescheduling_url": "https://example.com/reschedule/<BOOKING_REFERENCE>",
        "participant_cancellation_url": "https://example.com/cancel/<BOOKING_REFERENCE>",
        "host_language": "en",
        "guest_language": "en",
        "title": "[PENDING] Project sync",
        "duration": 60,
        "location": "https://meet.google.com/abc-defg-hij",
        "organizer_timezone": "America/New_York",
        "guest_timezone": "America/New_York",
        "is_group_event": false,
        "organizer_calendar_id": "primary",
        "event_description": "Let's discuss the project details",
        "event_html_link": "https://calendar.google.com/event?eid=abc123",
        "ical_uid": "040000008200E00074C5B7101A82E0080000000000000000000000000000000000",
        "host_confirmation_url": "https://example.com/confirm/<BOOKING_REFERENCE>"
      }
    }
  }
}
```