Create Service

post

https://api.vcita.biz/v2/settings/services

Overview

Creates a new service for the business. This is the write endpoint for services — the read-only list is at GET /platform/v1/services.

Available for Staff tokens.

Important

POST /platform/v1/services does NOT exist (returns 404). Always use this endpoint (POST /v2/settings/services) to create services.

Body Params

name

string

required

Display name of the service (e.g., "Executive Strategy Consultation").

service_type

string

enum

Defaults to appointment

The kind of service to create. Use appointment for standard one-on-one services (default) or event for group events/workshops.

Allowed:

duration

integer

required

Duration of the service in minutes (e.g., 30, 45, 60).

charge_type

string

enum

How the service is charged. no_price for free services, paid for priced services, free for explicitly free services.

Allowed:

price

number

Price of the service in the smallest currency unit. Set to 0 for free services.

currency

string

ISO 4217 currency code (e.g., "USD", "EUR").

interaction_type

string

enum

How the service is delivered.

Allowed:

description

string

A detailed description of the service shown to clients.

display

boolean

Whether the service is visible in the client-facing booking page. Defaults to true.

approval_mode

string

enum

How bookings for this service are approved. immediate for auto-approval, manual for staff review.

Allowed:

staff_uids

array of strings

Array of staff member UIDs who can provide this service.

staff_uids

200Service created successfully.