Skip to main content
POST
/
v1
/
event-types
cURL
curl --request POST \
  --url https://api.novacal.io/v1/event-types \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "<string>",
  "slug": "<string>",
  "type": "one_on_one",
  "duration": 720,
  "hidden_from_profile": true,
  "color": "<string>",
  "description": "<string>",
  "max_group_size": 6,
  "team_id": 123
}
'
{
  "success": true,
  "data": {
    "id": 123,
    "name": "<string>",
    "slug": "<string>",
    "description": "<string>",
    "type": "one_on_one",
    "duration": 720,
    "max_group_size": 6,
    "hidden_from_profile": true,
    "color": "<string>",
    "form_fields": [
      {
        "identifier": "<string>",
        "label": "<string>",
        "type": "<string>",
        "placeholder": "<string>",
        "is_required": true,
        "options": [
          "<string>"
        ]
      }
    ]
  }
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json

Event type to create

​
name
string
required

The name of the event type

Maximum string length: 55
​
slug
string
required

The URL-friendly identifier (must be unique)

Maximum string length: 80
​
type
enum<string>
required

The type of event

Available options:
one_on_one,
group,
round_robin,
collective
​
duration
integer
required

Duration in minutes

Required range: 1 <= x <= 1440
​
hidden_from_profile
boolean
required

Whether the event type is hidden from profile

​
color
string
required

Color code in hex format (e.g., #FF5733)

​
description
string

Description of the event type

Maximum string length: 5000
​
max_group_size
integer

Maximum group size (required for group type, min: 2, max: 10)

Required range: 2 <= x <= 10
​
team_id
integer

Team ID (required for collective type)

Response

201 - application/json

Event type created

​
success
boolean
required

Indicates whether the request was successful

Example:

true

​
data
object
required

The response data. Can be an object, array, or null