curl --request POST \
--url https://{your-subdomain}.neetocal.com/api/external/v2/meeting-templates \
--header 'Content-Type: application/json' \
--header 'X-Api-Key: <x-api-key>' \
--data '
{
"slug": "meeting-with-oliver-smith",
"name": "Meeting with Oliver Smith",
"duration": 30,
"description": "Discuss project updates",
"hosts": [
"oliver@example.com",
"jane@example.com"
],
"kind": "one_on_one",
"start_time_increment": 30,
"before_buffer_time": 0,
"after_buffer_time": 0,
"is_multiple_durations_allowed": false,
"is_multiple_spots_allowed": false,
"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",
"allow_multiple_add_on_services": true,
"durations": [
{
"id": "4ece6b6b-4b5f-4c15-9122-a85af189198c",
"duration": 30,
"is_default": true,
"created_at": "2025-08-18T07:43:16.775Z",
"updated_at": "2025-08-18T08:03:58.019Z"
}
],
"spots": [
{
"id": "bcc90342-9345-4d89-9144-d25d7c7b3521",
"spot": "zoom",
"is_default": true,
"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"
}
]
}
'const options = {
method: 'POST',
headers: {'X-Api-Key': '<x-api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
slug: 'meeting-with-oliver-smith',
name: 'Meeting with Oliver Smith',
duration: 30,
description: 'Discuss project updates',
hosts: ['oliver@example.com', 'jane@example.com'],
kind: 'one_on_one',
start_time_increment: 30,
before_buffer_time: 0,
after_buffer_time: 0,
is_multiple_durations_allowed: false,
is_multiple_spots_allowed: false,
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',
allow_multiple_add_on_services: true,
durations: [
{
id: '4ece6b6b-4b5f-4c15-9122-a85af189198c',
duration: 30,
is_default: true,
created_at: '2025-08-18T07:43:16.775Z',
updated_at: '2025-08-18T08:03:58.019Z'
}
],
spots: [
{
id: 'bcc90342-9345-4d89-9144-d25d7c7b3521',
spot: 'zoom',
is_default: true,
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'
}
]
})
};
fetch('https://{your-subdomain}.neetocal.com/api/external/v2/meeting-templates', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://{your-subdomain}.neetocal.com/api/external/v2/meeting-templates"
payload = {
"slug": "meeting-with-oliver-smith",
"name": "Meeting with Oliver Smith",
"duration": 30,
"description": "Discuss project updates",
"hosts": ["oliver@example.com", "jane@example.com"],
"kind": "one_on_one",
"start_time_increment": 30,
"before_buffer_time": 0,
"after_buffer_time": 0,
"is_multiple_durations_allowed": False,
"is_multiple_spots_allowed": False,
"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",
"allow_multiple_add_on_services": True,
"durations": [
{
"id": "4ece6b6b-4b5f-4c15-9122-a85af189198c",
"duration": 30,
"is_default": True,
"created_at": "2025-08-18T07:43:16.775Z",
"updated_at": "2025-08-18T08:03:58.019Z"
}
],
"spots": [
{
"id": "bcc90342-9345-4d89-9144-d25d7c7b3521",
"spot": "zoom",
"is_default": True,
"phone_call_number": None,
"in_person_location": None,
"custom_text": None,
"created_at": "2025-08-18T07:19:28.341Z",
"updated_at": "2025-08-18T07:35:32.822Z"
}
]
}
headers = {
"X-Api-Key": "<x-api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text){
"meeting_template": {
"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,
"before_buffer_time": 0,
"after_buffer_time": 0,
"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,
"allow_multiple_add_on_services": 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": [
{
"id": "1b217cc5-69b5-4fb1-a13c-c22f9c14e7f9",
"amount": "120.0",
"currency": "inr",
"feeable_id": "aff17ff8-1bf8-4e77-a3c5-2f86104f9a20",
"feeable_type": "Meeting",
"payment_provider": "cash",
"kind": "fixed",
"min_amount": "120.0",
"is_default": true,
"display_amount": "<string>",
"is_tax_enabled": true,
"is_tip_enabled": true,
"is_tax_applicable_on_tip": true,
"vpas": [
{}
],
"recipient": {
"id": "<string>",
"fee_id": "<string>",
"accountable": {}
},
"amount_in_smallest_currency_unit": 12000
}
],
"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": "oliver@example.com"
}
],
"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"
}
],
"add_on_services": [
{
"id": "77150ec6-d4f0-4665-98f0-34bda69f7b3a",
"name": "Sauna",
"description": "20 minutes in the sauna",
"duration": 30,
"position": 1,
"price": "25.5",
"currency": "usd",
"payment_provider": "stripe",
"created_at": "2026-10-06T18:26:08.033Z",
"updated_at": "2026-10-06T18:26:08.264Z"
}
]
}
}Create scheduling link template
Create a scheduling link template, a reusable preset that can seed new scheduling links through template_id.
curl --request POST \
--url https://{your-subdomain}.neetocal.com/api/external/v2/meeting-templates \
--header 'Content-Type: application/json' \
--header 'X-Api-Key: <x-api-key>' \
--data '
{
"slug": "meeting-with-oliver-smith",
"name": "Meeting with Oliver Smith",
"duration": 30,
"description": "Discuss project updates",
"hosts": [
"oliver@example.com",
"jane@example.com"
],
"kind": "one_on_one",
"start_time_increment": 30,
"before_buffer_time": 0,
"after_buffer_time": 0,
"is_multiple_durations_allowed": false,
"is_multiple_spots_allowed": false,
"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",
"allow_multiple_add_on_services": true,
"durations": [
{
"id": "4ece6b6b-4b5f-4c15-9122-a85af189198c",
"duration": 30,
"is_default": true,
"created_at": "2025-08-18T07:43:16.775Z",
"updated_at": "2025-08-18T08:03:58.019Z"
}
],
"spots": [
{
"id": "bcc90342-9345-4d89-9144-d25d7c7b3521",
"spot": "zoom",
"is_default": true,
"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"
}
]
}
'const options = {
method: 'POST',
headers: {'X-Api-Key': '<x-api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
slug: 'meeting-with-oliver-smith',
name: 'Meeting with Oliver Smith',
duration: 30,
description: 'Discuss project updates',
hosts: ['oliver@example.com', 'jane@example.com'],
kind: 'one_on_one',
start_time_increment: 30,
before_buffer_time: 0,
after_buffer_time: 0,
is_multiple_durations_allowed: false,
is_multiple_spots_allowed: false,
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',
allow_multiple_add_on_services: true,
durations: [
{
id: '4ece6b6b-4b5f-4c15-9122-a85af189198c',
duration: 30,
is_default: true,
created_at: '2025-08-18T07:43:16.775Z',
updated_at: '2025-08-18T08:03:58.019Z'
}
],
spots: [
{
id: 'bcc90342-9345-4d89-9144-d25d7c7b3521',
spot: 'zoom',
is_default: true,
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'
}
]
})
};
fetch('https://{your-subdomain}.neetocal.com/api/external/v2/meeting-templates', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://{your-subdomain}.neetocal.com/api/external/v2/meeting-templates"
payload = {
"slug": "meeting-with-oliver-smith",
"name": "Meeting with Oliver Smith",
"duration": 30,
"description": "Discuss project updates",
"hosts": ["oliver@example.com", "jane@example.com"],
"kind": "one_on_one",
"start_time_increment": 30,
"before_buffer_time": 0,
"after_buffer_time": 0,
"is_multiple_durations_allowed": False,
"is_multiple_spots_allowed": False,
"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",
"allow_multiple_add_on_services": True,
"durations": [
{
"id": "4ece6b6b-4b5f-4c15-9122-a85af189198c",
"duration": 30,
"is_default": True,
"created_at": "2025-08-18T07:43:16.775Z",
"updated_at": "2025-08-18T08:03:58.019Z"
}
],
"spots": [
{
"id": "bcc90342-9345-4d89-9144-d25d7c7b3521",
"spot": "zoom",
"is_default": True,
"phone_call_number": None,
"in_person_location": None,
"custom_text": None,
"created_at": "2025-08-18T07:19:28.341Z",
"updated_at": "2025-08-18T07:35:32.822Z"
}
]
}
headers = {
"X-Api-Key": "<x-api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text){
"meeting_template": {
"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,
"before_buffer_time": 0,
"after_buffer_time": 0,
"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,
"allow_multiple_add_on_services": 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": [
{
"id": "1b217cc5-69b5-4fb1-a13c-c22f9c14e7f9",
"amount": "120.0",
"currency": "inr",
"feeable_id": "aff17ff8-1bf8-4e77-a3c5-2f86104f9a20",
"feeable_type": "Meeting",
"payment_provider": "cash",
"kind": "fixed",
"min_amount": "120.0",
"is_default": true,
"display_amount": "<string>",
"is_tax_enabled": true,
"is_tip_enabled": true,
"is_tax_applicable_on_tip": true,
"vpas": [
{}
],
"recipient": {
"id": "<string>",
"fee_id": "<string>",
"accountable": {}
},
"amount_in_smallest_currency_unit": 12000
}
],
"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": "oliver@example.com"
}
],
"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"
}
],
"add_on_services": [
{
"id": "77150ec6-d4f0-4665-98f0-34bda69f7b3a",
"name": "Sauna",
"description": "20 minutes in the sauna",
"duration": 30,
"position": 1,
"price": "25.5",
"currency": "usd",
"payment_provider": "stripe",
"created_at": "2026-10-06T18:26:08.033Z",
"updated_at": "2026-10-06T18:26:08.264Z"
}
]
}
}{your-subdomain} with your workspace’s subdomain. Learn how to find your subdomain in Workspace subdomain.
Headers
Use the X-Api-Key header to provide your workspace API key. Refer to Authentication for more information.
Body
Slug of the scheduling link. This value should be unique.
"meeting-with-oliver-smith"
Name of the scheduling link.
"Meeting with Oliver Smith"
Duration of the scheduling link in minutes.
30
Description of the scheduling link.
"Discuss project updates"
Emails of the hosts of scheduling link in array format.
["oliver@example.com", "jane@example.com"]
Kind of scheduling link.
one_on_one, round_robin, multihost, grouped Start time increment for the scheduling link in minutes. Defaults to 30.
30
Buffer time in minutes before each meeting to allow for setup, preparation, or travel time. Must be between 0 and 1440 (24 hours).
0 <= x <= 14400
Buffer time in minutes after each meeting to allow for wrap-up, notes, or preparation for the next meeting. Must be between 0 and 1440 (24 hours).
0 <= x <= 14400
Whether users can select from multiple meeting duration options.
false
Whether users can select from multiple meeting platforms/locations.
false
Phone number for the meeting when place is set to phone_call.
"+1-555-0123"
Custom meeting instructions or details when meeting place is set to custom.
"Custom meeting instructions"
Physical location details when meeting place 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"
Whether people booking can choose more than one add-on service. Manage the add-on services themselves with the add-on services endpoints.
true
Array of duration options 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 (1-1440).
30
Whether this duration is the default option.
true
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"
Array of place options when multiple places are allowed.
Hide child attributes
Hide child attributes
Unique identifier for the meeting place option.
"bcc90342-9345-4d89-9144-d25d7c7b3521"
The place type for the meeting.
daily, zoom, jitsi, google_meet, teams, whereby, in_person, custom, phone_call "zoom"
Whether this meeting place is the default option.
true
Phone number for phone call meeting place. Only populated when place type is "phone_call", otherwise null.
null
Location details for in-person meetings. Only populated when place type is "in_person", otherwise null.
null
Custom text for custom meeting place. Only populated when place type is "custom", otherwise null.
null
Timestamp when the meeting place option was created.
"2025-08-18T07:19:28.341Z"
Timestamp when the meeting place option was last updated.
"2025-08-18T07:35:32.822Z"
Response
Created - Resource created successfully
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 meeting place is set to in_person.
Custom meeting instructions or details when meeting place is set to custom.
Phone number for the meeting when place 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).
Buffer time in minutes before each meeting to allow for setup, preparation, or travel time. Must be between 0 and 1440 (24 hours).
0 <= x <= 14400
Buffer time in minutes after each meeting to allow for wrap-up, notes, or preparation for the next meeting. Must be between 0 and 1440 (24 hours).
0 <= x <= 14400
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 places.
Whether users can select from multiple meeting duration options.
Whether people booking can choose more than one add-on service.
true
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"
Fees or charges associated with the meeting (scheduling link).
Hide child attributes
Hide child attributes
Unique identifier for the fee configuration.
"1b217cc5-69b5-4fb1-a13c-c22f9c14e7f9"
The fee amount as a string to preserve decimal precision.
"120.0"
The currency code for the fee amount. Follows the ISO 4217 standard (e.g., "inr", "usd").
"inr"
ID of the entity this fee is associated with (meeting ID in this case).
"aff17ff8-1bf8-4e77-a3c5-2f86104f9a20"
Type of entity this fee is associated with.
"Meeting"
Payment service provider used for processing payments.
stripe, razorpay, cash, paypal, dodopayments "cash"
Type of fee structure (e.g., "fixed", "percentage").
"fixed"
Minimum amount that can be charged for this fee.
"120.0"
Indicates whether this is the default fee configuration for the meeting.
Custom display amount for the fee (if different from the actual amount).
Whether tax calculation is enabled for this fee.
Whether tipping is enabled for this fee.
Whether taxes are calculated on top of tips.
Virtual Payment Addresses for UPI payments (India-specific).
The payment recipient configured for this fee.
Fee amount in the smallest currency unit (e.g., paise for INR, cents for USD).
12000
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"
Hide child attributes
Hide child attributes
Unique identifier for the meeting place option.
"bcc90342-9345-4d89-9144-d25d7c7b3521"
The place type for the meeting.
daily, zoom, jitsi, google_meet, teams, whereby, in_person, custom, phone_call "jitsi"
Whether this meeting place is the default option.
false
Phone number for phone call meeting place. Only populated when place type is "phone_call", otherwise null.
null
Location details for in-person meetings. Only populated when place type is "in_person", otherwise null.
null
Custom text for custom meeting place. Only populated when place type is "custom", otherwise null.
null
Timestamp when the meeting place option was created.
"2025-08-18T07:19:28.341Z"
Timestamp when the meeting place option was last updated.
"2025-08-18T07:35:32.822Z"
Add-on services people can choose when booking, in display order.
Hide child attributes
Hide child attributes
Unique identifier for the add-on service.
"77150ec6-d4f0-4665-98f0-34bda69f7b3a"
Name of the add-on service shown to the person booking.
"Sauna"
Description of the add-on service.
"20 minutes in the sauna"
Minutes the add-on service adds to the booking.
0 <= x <= 144030
Display order of the add-on service, starting at 1.
1
Price of the add-on service in the major unit of currency, returned as a decimal string to keep its exact value (the request takes it as a number). null when the add-on service is free.
"25.5"
Currency of price, taken from the scheduling link's fee. null when the add-on service is free.
"usd"
Payment provider used to collect price, taken from the scheduling link's fee. null when the add-on service is free.
"stripe"
Timestamp when the add-on service was created.
"2026-10-06T18:26:08.033Z"
Timestamp when the add-on service was last updated.
"2026-10-06T18:26:08.264Z"