# Place a Hold on an Event **URL:** \ **Category:** Question and Answers\ **Tags:** scheduler\ **Created:** [August 18, 2025, 3:27pm UTC](https://forums.nylas.com/t/place-a-hold-on-an-event/870 "2025-08-18T15:27:29Z")\ **Posts on this page:** 6\ **Page:** 1
**Author:** ![jonathan](https://avatars.discourse-cdn.com/v4/letter/j/aeb1de/32.png) [@jonathan](https://forums.nylas.com/u/jonathan)\ **Post date:** [August 18, 2025, 3:27pm UTC](https://forums.nylas.com/t/place-a-hold-on-an-event/870/1 "2025-08-18T15:27:29Z")
Is it possible to bypass the confirmation email if we want to temporarily hold a time slot for a client? Alternatively, is there a way to book an event with a “PENDING” status? Our goal is to allow a client to book a time with the organizer of the event, hold that time for about 10 minutes, and then release it if payment isn’t received. Do you have any suggestions or current methods within the software to achieve this? ---
**Author:** ![sam](https://sea1.discourse-cdn.com/flex015/user_avatar/forums.nylas.com/sam/32/287_2.png) [@sam](https://forums.nylas.com/u/sam)\ **Post date:** [August 18, 2025, 8:30pm UTC](https://forums.nylas.com/t/place-a-hold-on-an-event/870/2 "2025-08-18T20:30:05Z")
Yes, we offer pre-build bookings, this is outlined in [this](https://developer.nylas.com/docs/v3/scheduler/customize-booking-flows/) documentation. There is also a workaround, which you can use following these instructions: Nylas Scheduler v3 has a built-in solution for this exact use case through the `organizer-confirmation` booking type.PENDING Status Bookings When you set the `booking_type` to `organizer-confirmation`, Nylas creates an event marked “Pending” in the organizer’s calendar and sends a confirmation request email to the organizer. The booking entry is created with the `pending` status. ```auto json { "event_booking": { "booking_type": "organizer-confirmation" } } ``` How the Flow Works The booking flow for `organizer-confirmation` performs these steps: 1. Validates the provided session ID and uses it to retrieve the related Configuration object 2. Confirms if the selected time slot is still available 3. Retrieves the booking participant’s `grant_id`, using the list of participants’ email addresses in the Configuration object 4. Creates a placeholder event in the organizer’s calendar 5. Creates a booking entry with the `pending` status 6. Nylas creates a booking reference based on the configuration ID and the booking ID 7. Emits a pending booking (`booking.pending`) webhook Managing Pending Bookings You can use the `PUT /v3/scheduling/bookings/{booking_id}` request to allow the organizer to confirm or cancel a pending booking. This gives you programmatic control over finalizing or releasing the time slot. Bypassing Confirmation Emails If you want to bypass confirmation emails entirely, you can set `disable_emails` to `true` in your configuration: ```auto json { "event_booking": { "disable_emails": true } } ``` This approach with `organizer-confirmation` booking type gives you the temporary hold functionality you’re looking for, with the ability to programmatically confirm or cancel based on your payment processing workflow. Additional documentation: - [Nylas Scheduler APIs](https://developer.nylas.com/docs/api/v3/scheduler/) - [Notification schemas](https://developer.nylas.com/docs/v3/notifications/notification-schemas/) ---
**Author:** ![jonathan](https://avatars.discourse-cdn.com/v4/letter/j/aeb1de/32.png) [@jonathan](https://forums.nylas.com/u/jonathan)\ **Post date:** [August 18, 2025, 8:57pm UTC](https://forums.nylas.com/t/place-a-hold-on-an-event/870/3 "2025-08-18T20:57:49Z")
Thanks for the quick reply. The the flow you have outlined doesn’t work because when I set ```json { "event_booking": { "booking_type": "organizer-confirmation" } } ``` The configuration for the scheduler requires the organizer confirmation url. I don’t want the organizer to have to confirm the pending booking. I want to be able to just confirm it automatically when a payment is received. I still want the confirmation and reschedule emails to be sent to the participants when the booking is actually booked so I don’t want to set disable emails. ---
**Author:** ![sam](https://sea1.discourse-cdn.com/flex015/user_avatar/forums.nylas.com/sam/32/287_2.png) [@sam](https://forums.nylas.com/u/sam)\ **Post date:** [August 19, 2025, 7:32pm UTC](https://forums.nylas.com/t/place-a-hold-on-an-event/870/4 "2025-08-19T19:32:00Z")
When you receive a notification that the payment is successful, can you make the PUT call to confirm it? I believe that may meet your use case, considering you do not want the organizer to have to confirm the pending booking, you should be able to use this API: [Confirm a booking](https://developer.nylas.com/docs/api/v3/scheduler/?_gl=1*4ffz46*_ga*NDY5NjUxNTY1LjE3MjY2NTc2NTI.*_ga_5LVXVXFW0C*czE3NTU2MDI4NTIkbzE3JGcxJHQxNzU1NjI4Njk2JGo0JGwwJGgw#tag/bookings/put/v3/scheduling/bookings/%7Bbooking_id%7D) ---
**Author:** ![jonathan](https://avatars.discourse-cdn.com/v4/letter/j/aeb1de/32.png) [@jonathan](https://forums.nylas.com/u/jonathan)\ **Post date:** [August 19, 2025, 7:59pm UTC](https://forums.nylas.com/t/place-a-hold-on-an-event/870/5 "2025-08-19T19:59:25Z")
Would the organizer still get an email to confirm? I know I can confirm through the API, I guess the question is, does the organizer have to get an email to ask them to confirm because according to the docs they do, here: [Customizing Scheduler booking flows | Docs](https://developer.nylas.com/docs/v3/scheduler/customize-booking-flows/#set-up-organizer-confirmed-booking) ---
**Author:** ![Samuel.R](https://avatars.discourse-cdn.com/v4/letter/s/6bbea6/32.png) [@Samuel.R](https://forums.nylas.com/u/Samuel.R)\ **Post date:** [October 30, 2025, 8:32pm UTC](https://forums.nylas.com/t/place-a-hold-on-an-event/870/6 "2025-10-30T20:32:00Z")
Hello Jonathan, Thanks for the follow-up question. Let me clarify how the emails work with the organizer-confirmation booking type. To directly answer your question: Yes, with booking\_type: `"organizer-confirmation"` and `disable_emails: false`, the organizer will receive an initial “Booking requested” email when the pending booking is created. This email includes the confirmation link. However, you don’t need to wait for the organizer to click that link—you can confirm the booking programmatically via the API. Here’s what happens in each stage: 1. When the pending booking is created: - Organizer receives a “Booking requested on [date]” email with confirmation link - Guest receives NO email yet 2. When you call the [Confirm Booking API](https://developer.nylas.com/docs/api/v3/scheduler/#tag/bookings/PUT/v3/scheduling/bookings/%7Bbooking_id%7D) after payment succeeds: - ✅ Organizer receives a “Booking confirmed” email - ✅ Guest receives a “Booking confirmed” email with reschedule/cancel links - ✅ The pending event is replaced with the confirmed booking Workaround for your use case: Since the organizer\_confirmation\_url is required when using booking\_type: “organizer-confirmation”, you can set a placeholder URL that satisfies the validation requirement: ```auto { "event_booking": { "booking_type": "organizer-confirmation" }, "scheduler": { "organizer_confirmation_url": "https://yourdomain.com/confirmation/:booking_ref" } } ``` You won’t actually direct the organizer to use this URL since you’ll handle confirmation programmatically. The initial organizer email will still be sent, but you can think of it as a notification that a booking request was made rather than an action item. If you absolutely cannot have the organizer receive that initial email: Your only option is to set `disable_emails: true` and manage all email notifications yourself using a separate email service. With this approach: - No emails are sent when the pending booking is created - No emails are sent when you confirm via API - You would need to send your own confirmation/reschedule emails to both organizer and guests after payment Let me know if you’d like help implementing either approach, or if you have any other questions! Best regards, Samuel R. Support Engineer, Nylas