Skip to main content
Create a new meeting type that defines the rules for a type of meeting, such as its title and duration.

​
Endpoint

POST /v4/meeting-type

​
Request Headers

HeaderRequiredDescription
AuthorizationYesBearer <your-api-key>
x-meetergo-api-user-idYesUUID of the user who owns the meeting type
Content-TypeYesapplication/json

​
Request Body

FieldTypeRequiredDescription
namestringYesDisplay name for the meeting type
durationnumberYesMeeting duration in minutes
slugstringNoURL-friendly identifier for the booking page
descriptionstringNoDescription shown on the booking page

​
Examples

​
Basic Request

curl -X POST "https://api.meetergo.com/v4/meeting-type" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "x-meetergo-api-user-id: 550e8400-e29b-41d4-a716-446655440000" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Quick 15min Chat",
    "duration": 15,
    "slug": "quick-chat"
  }'

​
With Description

{
  "name": "Product Demo",
  "duration": 45,
  "slug": "product-demo",
  "description": "A 45-minute walkthrough of our product features and how they can help your business."
}

​
Response

​
Success (201 Created)

{
  "id": "770e8400-e29b-41d4-a716-446655440002",
  "name": "Quick 15min Chat",
  "duration": 15,
  "slug": "quick-chat",
  "bookingUrl": "https://cal.meetergo.com/john-smith/quick-chat",
  "createdAt": "2024-01-15T10:30:00Z"
}
FieldDescription
idUUID of the created meeting type
nameDisplay name for the meeting type
durationMeeting duration in minutes
slugURL-friendly identifier
bookingUrlPublic URL where customers can book this meeting type
createdAtCreation timestamp

​
Error Responses

​
400 Bad Request - Validation Error

{
  "statusCode": 400,
  "message": "Validation failed",
  "errors": [
    {
      "field": "duration",
      "message": "Duration must be a positive number"
    }
  ]
}

​
409 Conflict - Slug Already Exists

{
  "statusCode": 409,
  "message": "A meeting type with this slug already exists",
  "error": "Conflict"
}

​
Common Durations

DurationUse Case
15 minQuick check-ins, brief consultations
30 minStandard meetings, initial calls
45 minDiscovery calls, demos
60 minDeep-dive sessions, workshops
90 minTraining sessions, comprehensive reviews

List Meeting Types

Get all meeting types for a user

Update Meeting Type

Modify an existing meeting type