Create Service

Create a new service in the calendar system.

Request

POST /v2/services

Headers

Name	Required	Description
x-api-key	Yes	Your API key
x-api-secret	Yes	Your API secret

Body Parameters

Parameter	Type	Required	Description
name	string	Yes	Name of the service
description	string	No	Detailed description of the service
imageUrl	string	No	URL of the service image
dateRanges	array	No	Date ranges when the service is available
bookingOptions	object	No	Configuration for booking rules
calendars	array	No	Calendars associated with this service
extraFields	object	No	Additional custom fields

Response

Success Response (201 Created)

{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "name": "Professional Consultation",
  "description": "A comprehensive consultation service",
  "imageUrl": "https://example.com/service-image.png",
  "dateRanges": [
    {
      "start": "2025-05-22T10:30:00Z",
      "end": "2025-05-22T18:30:00Z"
    }
  ],
  "bookingOptions": {
    "duration": 60,
    "bufferTime": 15,
    "maxParticipants": 1,
    "autoAccept": true
  },
  "createdAt": "2025-05-22T10:30:00Z",
  "updatedAt": "2025-05-22T10:30:00Z"
}

Error Responses

Status	Description
400	Bad Request - Invalid parameters
401	Unauthorized - Invalid API key or secret
403	Forbidden - Insufficient permissions
409	Conflict - Service with same name already exists