---
title: "Create a service"
method: POST
path: "/api/v1/event_categories"
tags: ["Packages & Services"]
---

# Create a service

`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`

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`

## Headers

- `Api-Key` string, required

## Request body

- object
  - `name` string, required: The name of the service (e.g., "DJ Services")
  - `sub_header` string: 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_page` boolean: 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_venue` boolean: Allow customers to skip the venue/location step
  - `has_designs` boolean: 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_title` string: Label used for the staff role on this service (e.g., "DJ", "Attendant")
  - `staff_allows_overbooking` boolean: Allow bookings even when staff may be fully booked

## Response `200`

service created

---

[API](https://skmtc.dev/checkcherry/apis/check-cherry-business-api.md) · [All operations](https://skmtc.dev/checkcherry/apis/check-cherry-business-api/llms.txt) · [OpenAPI document](https://skmtc.dev/checkcherry/apis/check-cherry-business-api/revisions/84a9aabdf519?raw)