- Products
-
Email and Contacts API Unified bi-directional sync and parsing for any provider.
-
Calendar API & Scheduler Real-time availability and embeddable white-label booking.
-
Notetaker API Capture, transcribe, and extract structured data from meetings.
-
Agent Accounts Deploy, automate, and execute intelligent actions on your behalf.
-
- Solutions
- Developers
Sales & CRM 
Recruiting & ATS 
Healthcare
Financial
Legal
Real Estate
Education
Field Services
Docs
SDKs
Tutorials
API status
Changelog
Support
Jump to section
Jump to section
Easily set one-off time slots without changing your regular open hours
- Override existing availability for unique scheduling needs
- Works with all meeting types, including 1:1, group, & round robin
- Automatically expires so no one can book outdated slots
We’ve added a new way to control when people can book time with you in Scheduler: Specific Time Availability.
Nylas Scheduler lets your users set recurring open hours and block certain dates. Now, with Specific Time Availability, you can add one-time availability windows that take priority over your regular schedule and disappear automatically once they expire.
Specific Time Availability is designed to support a variety of scheduling needs, such as:
- Offering meetings only at manually chosen times.
- Setting availability for a specific date and time combination.
- Temporarily overriding standard hours without permanently editing them.
This flexibility helps your users accommodate special events, seasonal schedules, or last-minute availability changes without impacting your regular calendar settings.
How to use Specific Time Availability
With Scheduler Components v2.1.0, you can access Specific Time Availability in two places:
The Scheduler Editor UI
In the ‘Participants’ section of the Scheduler Editor, you can set the Specific time availability for a participant by adding one or more date and time ranges.
Adding these dates in the UI will work in conjunction with setting that participant’s Availability or open hours, but Specific time availability takes precedence.
The Scheduler /configurations endpoints
You can either POST or PUT Specific date availability when creating or updating a Configuration. The specific_time_availability object has three parts to it:
- A date for the new window of availability.
- A start time in the user’s timezone.
- An end time in the user’s timezone.
Here’s a sample request for updating an existing user’s configuration:
Update user’s configuration
curl --request PUT \
--url "https://api.us.nylas.com/v3/grants/<NYLAS_GRANT_ID>/scheduling/configurations/<SCHEDULER_CONFIGURATION_ID>" \
--header 'Accept: application/json, application/gzip' \
--header 'Authorization: Bearer <NYLAS_API_KEY>' \
--header 'Content-Type: application/json' \
--data '{
"participants": [
{
"name": "Nyla",
"email": "[email protected]",
"is_organizer": true,
"availability": {
"calendar_ids": ["primary"]
},
"booking": {
"calendar_id": "primary"
},
"specific_time_availability": [
{
"date": "2025-08-21",
"start": "09:00",
"end": "13:00"
},
{
"date": "2025-08-22",
"start": "10:00",
"end": "16:00"
}
]
}
]
}'Available Now
This new feature is available for all users of the Nylas Scheduler. In order to show it in your Scheduler Editor, please make sure you’re using the latest version of our Scheduler Editor package.
Want to try it out?
Sign in to your Nylas account or create a free Sandbox account to get started.
