Create an event type

POST

/v1/event_types

Creates a standard event type. Authentication supports x-jicoo-api-key or Authorization: Bearer .... X-Jicoo-Team is required when using Bearer authentication. Request body is flat (no eventType wrapper).

Request

Authorization

API Key

Add parameter in header

x-jicoo-api-key

Example:

x-jicoo-api-key: ********************

JWT Bearer

Add the parameter

Authorization

to Headers

Example:

Authorization: ********************

Header Params

Body Params application/jsonRequired

Example

{
    "name": "30min intro call",
    "description": "Introductory call for new prospects",
    "slug": "intro-call",
    "duration": 30,
    "intervalMinutes": 30,
    "maxCapacity": 1,
    "bufferBefore": 0,
    "bufferAfter": 0,
    "availableUserType": "all",
    "hostAssignType": "hostAssignRule",
    "roundRobinAllocateType": "allocateWeighting",
    "rescheduleType": "reassign",
    "location": {
        "isZoom": true,
        "phoneType": "none"
    },
    "eventTypeUsers": [
        {
            "userId": "user_uid_1",
            "role": "admin",
            "userType": "host",
            "priority": 0
        }
    ],
    "form": {
        "workflows": [
            {
                "uid": "wf_name",
                "workflowType": "name",
                "content": "Name",
                "isRequired": true
            },
            {
                "uid": "wf_email",
                "workflowType": "email",
                "content": "Email",
                "isRequired": true
            },
            {
                "uid": "wf_team_size",
                "workflowType": "dropdown",
                "content": "Team size",
                "isRequired": true,
                "choices": [
                    {
                        "uid": "c_1_10",
                        "value": "1-10"
                    },
                    {
                        "uid": "c_11_50",
                        "value": "11-50"
                    },
                    {
                        "uid": "c_51_plus",
                        "value": "51+"
                    }
                ]
            }
        ]
    }
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST '/v1/event_types' \
--header 'X-Jicoo-Team;' \
--header 'x-jicoo-api-key: <api-key>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "name": "30min intro call",
    "description": "Introductory call for new prospects",
    "slug": "intro-call",
    "duration": 30,
    "intervalMinutes": 30,
    "maxCapacity": 1,
    "bufferBefore": 0,
    "bufferAfter": 0,
    "availableUserType": "all",
    "hostAssignType": "hostAssignRule",
    "roundRobinAllocateType": "allocateWeighting",
    "rescheduleType": "reassign",
    "location": {
        "isZoom": true,
        "phoneType": "none"
    },
    "eventTypeUsers": [
        {
            "userId": "user_uid_1",
            "role": "admin",
            "userType": "host",
            "priority": 0
        }
    ],
    "form": {
        "workflows": [
            {
                "uid": "wf_name",
                "workflowType": "name",
                "content": "Name",
                "isRequired": true
            },
            {
                "uid": "wf_email",
                "workflowType": "email",
                "content": "Email",
                "isRequired": true
            },
            {
                "uid": "wf_team_size",
                "workflowType": "dropdown",
                "content": "Team size",
                "isRequired": true,
                "choices": [
                    {
                        "uid": "c_1_10",
                        "value": "1-10"
                    },
                    {
                        "uid": "c_11_50",
                        "value": "11-50"
                    },
                    {
                        "uid": "c_51_plus",
                        "value": "51+"
                    }
                ]
            }
        ]
    }
}'

Responses

🟢201

application/json

Event type created successfully.

Body

Example

{
    "data": {
        "uid": "string",
        "slug": "string",
        "name": "string",
        "description": "string",
        "coverImage": "string",
        "color": "string",
        "duration": 0,
        "status": "enable",
        "internalNote": "string",
        "locations": [
            {
                "locationId": "inPerson"
            }
        ],
        "questions": [
            {
                "property1": "string",
                "property2": "string"
            }
        ],
        "services": [
            {
                "property1": "string",
                "property2": "string"
            }
        ],
        "paymentMethods": [
            {
                "methodType": "none"
            }
        ],
        "availableUserType": "all",
        "hostAssignType": "none",
        "hostAssignRules": [
            {
                "property1": "string",
                "property2": "string"
            }
        ],
        "createdAt": "2019-08-24T14:15:22.123Z",
        "updatedAt": "2019-08-24T14:15:22.123Z"
    }
}

🟠400InvalidParams

🟠401UnauthorizedError

🟠403ForbiddenError

🟠405MethodNotAllowedError

🔴500InternalServerError

Modified at 2026-04-20 12:12:19

Update an event type

Delete an event type