Packages & Services

Create a service

Creates a new service (event category) for the business. A service is the top-level grouping for your offerings; packages and package groups are added to it separately.

Only name is required. A default placeholder image is attached automatically — you can replace it from the Package Manager in the app. New services are appended to the end of the service list.

Required permission: offerings_write

post/api/v1/event_categories

Request

  • Base URL: https://api.checkcherry.com
  • URL: https://api.checkcherry.com/api/v1/event_categories
  • Auth: none declared. Required headers: Api-Key

Headers

Api-Keystring required

Your Integration Key

Request body

namestring required

The name of the service (e.g., "DJ Services")

sub_headerstring

Short sub-heading shown under the service name on booking pages (max 90 characters)

status'public' | 'private' | 'disabled'

Booking-page visibility

show_title_on_booking_pageboolean

Whether to show the service title on the booking page

location_type'venue' | 'location' | 'property'

How the event location is labeled

location_booking_type'yes' | 'places' | 'places_or_custom' | 'brand_address' | 'no'

How customers provide a location during booking

allow_skip_venueboolean

Allow customers to skip the venue/location step

has_designsboolean

Whether this service includes a design selection step

staff_assignment_type'customer_choice' | 'assign_predefined_staff' | 'staff_may_request' | 'staff_may_claim' | 'none'

How staff are assigned to bookings

staff_titlestring

Label used for the staff role on this service (e.g., "DJ", "Attendant")

staff_allows_overbookingboolean

Allow bookings even when staff may be fully booked

Response

service created

Changes

No recorded changes to this operation across all 2 revisions of this API.