Getting Started
Scheduling links API
Meeting spots API
Meeting durations API
Bookings API
Availabilities API
Slots API
Discount Codes API
curl --request PATCH \
--url https://{your-workspace}.neetocal.com/api/external/v1/meetings/{meeting_sid} \
--header 'Content-Type: application/json' \
--header 'X-Api-Key: <x-api-key>' \
--data '
{
"hosts": [
"[email protected]",
"[email protected]"
],
"slug": "meeting-with-oliver-smith-new",
"name": "Meeting with Oliver Smith",
"description": "Discuss project updates",
"kind": "one_on_one",
"duration": 30,
"start_time_increment": 30,
"spot_phone_call_number": "+1-555-0123",
"spot_custom_text": "Custom meeting instructions",
"spot_in_person_location": "123 Main St, Suite 100",
"locked_time_zone": "America/New_York"
}
'{
"message": "<string>",
"meeting": {
"id": "<string>",
"sid": "<string>",
"name": "<string>",
"slug": "<string>",
"description": "<string>",
"kind": "one_on_one",
"duration": 123,
"disabled": true,
"spot": "custom",
"spot_in_person_location": "<string>",
"spot_custom_text": "<string>",
"spot_phone_call_number": "<string>",
"is_template": true,
"schedulable_range_type": "number_of_days_into_the_future",
"schedulable_range_value": "<string>",
"lead_time": 123,
"start_time_increment": 123,
"created_at": "2025-12-23T05:05:27.037Z",
"updated_at": "2025-03-31T13:22:19.832Z",
"deleted_at": null,
"is_multiple_spots_allowed": true,
"is_multiple_durations_allowed": true,
"conditional_pricing_enabled": true,
"is_email_reminders_enabled": true,
"is_sms_reminders_enabled": true,
"organization_id": "<string>",
"rescheduling_lead_time": 123,
"cancellation_lead_time": 123,
"booking_modification_allowed": true,
"cancellation_too_late_notice": "<string>",
"cancellation_policy": "<string>",
"rescheduling_too_late_notice": "<string>",
"pre_booking_allowed": true,
"original_price_enabled": true,
"original_price": 123,
"locked_time_zone": "America/New_York",
"fees": [
{}
],
"durations_possible": [
123
],
"durations": [
{
"id": "4ece6b6b-4b5f-4c15-9122-a85af189198c",
"duration": 30,
"is_default": false,
"created_at": "2025-08-18T07:43:16.775Z",
"updated_at": "2025-08-18T08:03:58.019Z"
}
],
"hosts": [
{
"name": "Oliver Smith",
"email": "[email protected]"
}
],
"spots": [
{
"id": "bcc90342-9345-4d89-9144-d25d7c7b3521",
"spot": "jitsi",
"is_default": false,
"phone_call_number": null,
"in_person_location": null,
"custom_text": null,
"created_at": "2025-08-18T07:19:28.341Z",
"updated_at": "2025-08-18T07:35:32.822Z"
}
]
}
}Update a scheduling link
This API allows to update a scheduling link.
curl --request PATCH \
--url https://{your-workspace}.neetocal.com/api/external/v1/meetings/{meeting_sid} \
--header 'Content-Type: application/json' \
--header 'X-Api-Key: <x-api-key>' \
--data '
{
"hosts": [
"[email protected]",
"[email protected]"
],
"slug": "meeting-with-oliver-smith-new",
"name": "Meeting with Oliver Smith",
"description": "Discuss project updates",
"kind": "one_on_one",
"duration": 30,
"start_time_increment": 30,
"spot_phone_call_number": "+1-555-0123",
"spot_custom_text": "Custom meeting instructions",
"spot_in_person_location": "123 Main St, Suite 100",
"locked_time_zone": "America/New_York"
}
'{
"message": "<string>",
"meeting": {
"id": "<string>",
"sid": "<string>",
"name": "<string>",
"slug": "<string>",
"description": "<string>",
"kind": "one_on_one",
"duration": 123,
"disabled": true,
"spot": "custom",
"spot_in_person_location": "<string>",
"spot_custom_text": "<string>",
"spot_phone_call_number": "<string>",
"is_template": true,
"schedulable_range_type": "number_of_days_into_the_future",
"schedulable_range_value": "<string>",
"lead_time": 123,
"start_time_increment": 123,
"created_at": "2025-12-23T05:05:27.037Z",
"updated_at": "2025-03-31T13:22:19.832Z",
"deleted_at": null,
"is_multiple_spots_allowed": true,
"is_multiple_durations_allowed": true,
"conditional_pricing_enabled": true,
"is_email_reminders_enabled": true,
"is_sms_reminders_enabled": true,
"organization_id": "<string>",
"rescheduling_lead_time": 123,
"cancellation_lead_time": 123,
"booking_modification_allowed": true,
"cancellation_too_late_notice": "<string>",
"cancellation_policy": "<string>",
"rescheduling_too_late_notice": "<string>",
"pre_booking_allowed": true,
"original_price_enabled": true,
"original_price": 123,
"locked_time_zone": "America/New_York",
"fees": [
{}
],
"durations_possible": [
123
],
"durations": [
{
"id": "4ece6b6b-4b5f-4c15-9122-a85af189198c",
"duration": 30,
"is_default": false,
"created_at": "2025-08-18T07:43:16.775Z",
"updated_at": "2025-08-18T08:03:58.019Z"
}
],
"hosts": [
{
"name": "Oliver Smith",
"email": "[email protected]"
}
],
"spots": [
{
"id": "bcc90342-9345-4d89-9144-d25d7c7b3521",
"spot": "jitsi",
"is_default": false,
"phone_call_number": null,
"in_person_location": null,
"custom_text": null,
"created_at": "2025-08-18T07:19:28.341Z",
"updated_at": "2025-08-18T07:35:32.822Z"
}
]
}
}{your-workspace} with your workspace’s subdomain. Learn how to find your subdomain in Identifying your subdomain.
Headers
X-Api-Key is used to authenticate requests using an API key. Provide your API key in this header to access protected endpoints. Refer to Authentication for more information.
Path Parameters
Id of the scheduling link you want to update.
Body
Emails of the hosts of scheduling link in array format.
New slug of the scheduling link. This value should be unique.
"meeting-with-oliver-smith-new"
New name of the scheduling link.
"Meeting with Oliver Smith"
Description of the scheduling link.
"Discuss project updates"
Kind of scheduling link.
one_on_one, round_robin, multihost, grouped Duration of the scheduling link in minutes.
30
Start time increment for the scheduling link in minutes. Defaults to 30.
30
Phone number for the meeting when spot is set to phone_call.
"+1-555-0123"
Custom meeting instructions or details when spot is set to custom.
"Custom meeting instructions"
Physical location details when spot is set to in_person.
"123 Main St, Suite 100"
Time zone to lock the scheduling link to. When set, all available times are displayed in this time zone regardless of the booker's location. Must be a valid IANA time zone identifier (e.g., 'America/New_York', 'Europe/London').
"America/New_York"
Response
OK - Request succeeded
Hide child attributes
Hide child attributes
Unique identifier for the scheduling link.
Short identifier (SID) for the meeting, used in URLs and API calls.
Display name of the scheduling link.
URL-friendly identifier for the meeting, used in public scheduling links.
Detailed description of the meeting purpose or agenda.
Type of meeting. one_on_one for individual meetings, round_robin for rotating hosts, multihost for multiple simultaneous hosts, grouped for group sessions.
one_on_one, round_robin, multihost, grouped Duration of the meeting in minutes.
Whether the scheduling link is currently disabled and not accepting bookings.
Meeting platform or location type for the scheduled meeting.
custom, jitsi, google_meet, daily, zoom, whereby, teams, phone_call, in_person Physical location details when spot is set to in_person.
Custom meeting instructions or details when spot is set to custom.
Phone number for the meeting when spot is set to phone_call.
Whether this meeting is a template that can be used to create other meetings.
How the scheduling range is calculated - by days into future, business days, or specific date range.
number_of_days_into_the_future, number_of_business_days_into_the_future, date_range Value for the scheduling range (e.g., number of days or date range).
Minimum advance notice required for booking in minutes.
Time increment in minutes for available booking slots (e.g., 30 for 30-minute slots).
Timestamp when the meeting was created.
"2025-12-23T05:05:27.037Z"
Timestamp when the meeting was last updated.
"2025-03-31T13:22:19.832Z"
Timestamp when the meeting was deleted (soft delete).
null
Whether users can select from multiple meeting platforms/locations.
Whether users can select from multiple meeting duration options.
Whether conditional pricing rules are applied to this meeting.
Whether email reminders are sent for this meeting.
Whether SMS reminders are sent for this meeting.
Unique identifier of the organization that owns this meeting.
Minimum advance notice required for rescheduling in minutes.
Minimum advance notice required for cancellation in minutes.
Whether users are allowed to modify their bookings after creation.
Custom message shown when cancellation is attempted too late.
Policy text explaining cancellation terms and conditions.
Custom message shown when rescheduling is attempted too late.
Whether users can book meetings in advance beyond the normal scheduling range.
Whether to show the original price alongside any discounted price.
Original price of the meeting before any discounts.
Time zone to lock the scheduling link to. When set, all available times are displayed in this time zone regardless of the booker's location. Must be a valid IANA time zone identifier (e.g., 'America/New_York', 'Europe/London').
"America/New_York"
Additional fees or charges associated with the meeting.
List of available duration options in minutes when multiple durations are allowed.
Hide child attributes
Hide child attributes
Unique identifier for the duration option.
"4ece6b6b-4b5f-4c15-9122-a85af189198c"
Duration in minutes.
30
Whether this duration is the default option.
false
Timestamp when the duration option was created.
"2025-08-18T07:43:16.775Z"
Timestamp when the duration option was last updated.
"2025-08-18T08:03:58.019Z"
List of hosts for the scheduling link with their name and email.
Hide child attributes
Hide child attributes
Full name of the host.
"Oliver Smith"
Email address of the host.
Hide child attributes
Hide child attributes
Unique identifier for the spot option.
"bcc90342-9345-4d89-9144-d25d7c7b3521"
The spot type for the meeting.
daily, zoom, jitsi, google_meet, teams, whereby, in_person, custom, phone_call "jitsi"
Whether this spot is the default option.
false
Phone number for phone call spots. Only populated when spot type is "phone_call", otherwise null.
null
Location details for in-person meetings. Only populated when spot type is "in_person", otherwise null.
null
Custom text for custom spots. Only populated when spot type is "custom", otherwise null.
null
Timestamp when the spot option was created.
"2025-08-18T07:19:28.341Z"
Timestamp when the spot option was last updated.
"2025-08-18T07:35:32.822Z"