curl --request POST \
--url https://{workspace}.neetocal.com/api/external/v1/bookings \
--header 'Content-Type: application/json' \
--header 'X-Api-Key: <x-api-key>' \
--data '{
"meeting_slug": "meeting-with-oliver-smith",
"name": "Eve Smith",
"email": "eve@example.com",
"slot_date": "2025-07-15",
"slot_start_time": "01:30 PM",
"time_zone": "Asia/Kolkata",
"preferred_meeting_spot": "jitsi",
"form_responses": {
"guest_email_s": [
"sam@example.com",
"charlie@example.com"
],
"language": "English"
}
}'
{
"id": "<string>",
"sid": "<string>",
"parent_booking_id": "<string>",
"email": "<string>",
"name": "<string>",
"host_name": "<string>",
"host_email": "<string>",
"is_multihost": true,
"multihosts": [
{
"name": "<string>",
"email": "<string>"
}
],
"starts_at": "2023-11-07T05:31:56Z",
"ends_at": "2023-11-07T05:31:56Z",
"time_zone": "<string>",
"starts_at_for_client": "<string>",
"ends_at_for_client": "<string>",
"status": "<string>",
"cancel_reason": "<string>",
"cancelled_by": "<string>",
"reschedule_requested": true,
"preferred_meeting_spot": "<string>",
"room_type": "<string>",
"room_url": "<string>",
"room_id": "<string>",
"spot_details": "<string>",
"created_at": "2023-11-07T05:31:56Z",
"updated_at": "2023-11-07T05:31:56Z",
"meeting_id": "<string>",
"meeting": {
"name": "<string>"
},
"no_show": true,
"meeting_outcome": "<string>",
"notes_url": "<string>",
"internal_notes": "<string>",
"metadata": {},
"admin_booking_url": "<string>",
"client_booking_url": "<string>",
"form_responses": [
{
"field": "<string>",
"value": "<string>",
"type": "<string>",
"field_code": "<string>"
}
]
}
This API allows to make a booking for a specific scheduling link, either in a particular slot or in the first available slot. To book the first available slot, remove slot_date
and slot_start_time
from the request body.
curl --request POST \
--url https://{workspace}.neetocal.com/api/external/v1/bookings \
--header 'Content-Type: application/json' \
--header 'X-Api-Key: <x-api-key>' \
--data '{
"meeting_slug": "meeting-with-oliver-smith",
"name": "Eve Smith",
"email": "eve@example.com",
"slot_date": "2025-07-15",
"slot_start_time": "01:30 PM",
"time_zone": "Asia/Kolkata",
"preferred_meeting_spot": "jitsi",
"form_responses": {
"guest_email_s": [
"sam@example.com",
"charlie@example.com"
],
"language": "English"
}
}'
{
"id": "<string>",
"sid": "<string>",
"parent_booking_id": "<string>",
"email": "<string>",
"name": "<string>",
"host_name": "<string>",
"host_email": "<string>",
"is_multihost": true,
"multihosts": [
{
"name": "<string>",
"email": "<string>"
}
],
"starts_at": "2023-11-07T05:31:56Z",
"ends_at": "2023-11-07T05:31:56Z",
"time_zone": "<string>",
"starts_at_for_client": "<string>",
"ends_at_for_client": "<string>",
"status": "<string>",
"cancel_reason": "<string>",
"cancelled_by": "<string>",
"reschedule_requested": true,
"preferred_meeting_spot": "<string>",
"room_type": "<string>",
"room_url": "<string>",
"room_id": "<string>",
"spot_details": "<string>",
"created_at": "2023-11-07T05:31:56Z",
"updated_at": "2023-11-07T05:31:56Z",
"meeting_id": "<string>",
"meeting": {
"name": "<string>"
},
"no_show": true,
"meeting_outcome": "<string>",
"notes_url": "<string>",
"internal_notes": "<string>",
"metadata": {},
"admin_booking_url": "<string>",
"client_booking_url": "<string>",
"form_responses": [
{
"field": "<string>",
"value": "<string>",
"type": "<string>",
"field_code": "<string>"
}
]
}
{your-workspace}
with your workspace’s subdomain. You can generate an API key from the NeetoCal API Keys dashboard.
OK - Request succeeded
The response is of type object
.