Scheduler V3 query

Hello. I a question regarding the working of calendar and scheduler.

So currently I have a virtual calendar which I’m using for appointments.

Now for this virtual calendar I want to setup a scheduler. Scheduler V3

So here:

  1. In the documentation attached above the steps says to create configuration and session, so here I have a question on how do we know that the configuration and session are created for the virtual calendar which I already have.
  2. The virtual calendar can have some independent events and thus it is also possible that the events can be present during the time range of the scheduler, so does the scheduler consider the events which are exactly not events from scheduler as busy and not allow people to book appointment for that time?

Additionally I have tried to make an api call to create a configuration but it fails with this error: {"error":{"message":"Bearer token invalid","type":"token.unauthorized_access"},"request_id":"a0514445-0e0a-4ba9-bc18-7c375ae0c744"}

But here I am 101% sure that I have provided the correct access token which starts with the nyk_

The api call goes like this (I have kept token and calendar id incomplete for the security reasons):

curl --request POST \
  --url "" \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer nyk_......' \
  --header 'Content-Type: application/json' \
  --data '{
    "version": "1.0.0",
    "participants": [
        "name": "Virtual Account 001",
        "email": "virtual-account-001",
        "is_organizer": true,
        "availability": {
          "calendar_ids": [
        "booking": {
          "calendar_id": "9de............"
    "availability": {
      "duration_minutes": 30,
      "availability_rules": {
        "default_open_hours": [{
          "days": [1,2,3,4,5],
          "timezone": "America/Los_Angeles",
          "start": "9:00",
          "end": "12:00"
    "event_booking": {
      "title": "My test event"
    "scheduler": {
      "available_days_in_future": 30

Hey there!

Thanks for your question! Let me try to provide some clarity to your questions - I also want to note that currently, Scheduler V3 is in “Private Preview” state, meaning some functionality is missing for a full, E2E experience. End of April is our target date for the next release.

  1. For any configuration you make, it will be tied to calendar IDs in the participants object. This can be the ID of a virtual calendar

  2. Any event in your virtual calendar will appear as “busy”, including non-Scheduler events

Hope this helps :slightly_smiling_face:

  • Antoine
    Product Manager, Nylas

Hi Antoine. Thank you for the quick response. The answers in the pointers 1 and 2 really helps, but
regarding the failure of create configuration api you are asking me to wait out till the E2E experience is released? It would be really great if you can check out the api call and confirm if it is correct and I’m not getting error because of one of my mistakes.

Hey your code seems to be correct, so rest easy!

This error I suspect is due to some updates we’re making to the endpoints right now (such is the nature of private preview) - yes our next release will have this addressed 100%, but honestly this should also be fixed (without your intervention) in the next week or two!