POST
/
meetings
Create a scheduling link
curl --request POST \
  --url https://{workspace}.neetocal.com/api/external/v1/meetings \
  --header 'Content-Type: application/json' \
  --header 'X-Api-Key: <x-api-key>' \
  --data '{
  "slug": "meeting-with-oliver-smith",
  "name": "Meeting with Oliver Smith",
  "description": "Discuss project updates",
  "hosts": [
    "oliver@example.com",
    "jane@example.com"
  ],
  "kind": "one_on_one",
  "duration": 30,
  "start_time_increment": 30
}'
{
  "message": "Meeting created successfully",
  "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": "2024-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,
    "fees": [
      {}
    ],
    "durations_possible": [
      123
    ]
  }
}
Replace {your-workspace} with your workspace’s subdomain.
Learn how to find your subdomain in Identifying your subdomain.

Headers

X-Api-Key
string
required

You can generate an API key from the NeetoCal API Keys dashboard.

Body

application/json

Response

200
application/json

OK - Request succeeded

The response is of type object.