Create a meeting link

Overview

The "Create a meeting" API allows users to create meeting-links.

Usage

Base URL

https://<organization>.neetocal.com/api/external/v1

Replace the <organization> with the desired organization's subdomain.

Endpoint

POST /meetings

Request header

This endpoint requires authentication. You must include a valid API key in the request header.

Header	Type	Required	Description
X-Api-Key	String	Yes	Bearer token for API access.

Request body

Key	Type	Required	Description
slug	String	Yes	The slug of the meeting link that you want to create. This value should be unique.
name	String	Yes	The name of the meeting link
description	String	No	The name of the meeting link
hosts	String	Yes	Array of email of hosts in the meeting.
kind	String	No	Kind of meeting. Available kinds are one_on_one, round_robin, and multihost. Defaults to one_on_one.
duration	Integer	Yes	Duration of the meeting.
start_time_increment	Integer	No	Start time increment for the meeting. Defaults to 30.

Example

For creating a meeting, "Meeting with Oliver Smith", with the slug meeting-with-oliver-smith of organization "Spinkart" with subdomain spinkart using curl

curl --request POST \
  --url 'https://spinkart.neetocal.com/api/external/v1/meetings' \
  --header 'X-Api-Key: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "slug": "meeting-with-oliver-smith",
    "name": "Meeting with Oliver Smith",
    "spot": "zoom",
    "duration": "60",
    "hosts": ["[email protected]"]
  }'

Response Codes

Code	Description
200	OK - Request succeeded
400	Bad Request - Missing/Invalid parameters
401	Unauthorized - Invalid API key
500	Internal server error