Skip to main content
POST

Authorizations

Authorization
string
header
required

An API key from Settings → API Keys (starts with tikk_sk_), or an OAuth access token for a partner app. Both carry scopes; each endpoint lists the one it needs.

Body

application/json

The writable fields of a default service.

type
string
required
Allowed value: "default"
title
string
required
Maximum string length: 50
Example:

"Intro call"

durations
object[]
required

Replaces all durations when sent.

Minimum array length: 1
description
string | null

Shown on the booking page.

Maximum string length: 500
slug
string

Lowercase letters, digits and single hyphens, unique among your services. Custom slugs need Pro: on Free the slug is generated from the title and a slug you send is ignored.

Maximum string length: 100
Pattern: ^[a-z0-9]+(?:-[a-z0-9]+)*$
Example:

"intro-call"

is_group
boolean

Several people can book the same slot. Needs Pro; true on Free returns 422.

max_attendees
integer | null

Seat cap. Required when is_group is true.

Required range: 2 <= x <= 50
requires_approval
boolean

Accept each booking by hand. Needs Pro; on Free, bookings are always accepted automatically.

location
object

Replaces the location when sent.

Response

The created service.

data
Default service · object
required

A permanent booking page, such as "Intro call".