---
title: "Create Event"
method: POST
path: "/locations/{location_id}/events"
tags: ["Events"]
---

# Create Event

`POST /locations/{location_id}/events`

Create a group Event for a Location.

## Path parameters

- `location_id` integer, required

## Query parameters

- `include` string[]

## Headers

- `Accept` string, required
- `Content-Type` 'application/json', required
- `Authorization` string, required

## Request body

- EventCreateRequest
  - `staff_id` integer, required — Team Member ID
  - `service_id` integer, required — Service ID
  - `resource_instance_ids` integer[], required — Resource Instance IDs; an empty array is allowed
  - `label_ids` integer[], required — Tag IDs; an empty array is allowed
  - `date` string, required — Event start in the Location timezone as `YYYY-MM-DD HH:MM:SS`
  - `length` integer, required — Total Event duration in seconds, including any technical break
  - `technical_break_duration` integer, nullable — Technical break in seconds; `null` uses the Location setting
  - `capacity` integer, required — Total number of available places
  - `comment` string — Event comment
  - `color` string — Event color including `#`
  - `instructions` string — Instructions for Booking Users
  - `stream_link` string — Online Event stream link
  - `force` boolean — Skip Team Member and Resource Instance availability conflicts

## Response `201`

Event created successfully

- EventItemResponse
  - `data` EventResource, required
    - `type` 'activity', required — Literal JSON:API resource type returned for Events
    - `id` string, required — Event ID
    - `attributes` object, required
      - `master_id` integer, required — Deprecated wire field for Team Member ID; use `staff_id`
      - `staff_id` integer, required — Team Member ID
      - `service_id` integer, required — Service ID
      - `timestamp` integer, required — Event start as a Unix timestamp
      - `length` integer, required — Event duration in seconds
      - `capacity` integer, required — Total number of available places
      - `clients_count` integer, required — Number of Booking Users currently booked
      - `color` string, required — Event background color including `#`
      - `instructions` string, required — Instructions for Booking Users
      - `stream_link` string, required — Online Event stream link, or an empty string
      - `font_color` string, required — Event text color including `#`
      - `notified` boolean, required — Whether an Event notification was sent
      - `comment` string, nullable, required — Event comment
      - `schedule_id` integer, nullable, required — Event Schedule ID
      - `schedule_till` object, nullable, required — Event Schedule end represented by the production DateTime wire object
        - `date` string, required
        - `timezone_type` integer, required
        - `timezone` string, required
      - `schedule_event_modified` boolean, nullable, required — Whether this scheduled Event differs from its Event Schedule
      - `date` string, required — Event start in the Location timezone with a numeric offset
    - `relationships` object — Present when related data is requested through `include`
      - `staff` ToOneRelationship
        - `data` ResourceIdentifier, required
          - `type` string, required
          - `id` string, required
      - `master` ToOneRelationship
        - `data` ResourceIdentifier, required
          - `type` string, required
          - `id` string, required
      - `service` ToOneRelationship
        - `data` ResourceIdentifier, required
          - `type` string, required
          - `id` string, required
      - `resource_instances` ToManyRelationship
        - `data` ResourceIdentifier[], required
          - `type` string, required
          - `id` string, required
      - `labels` ToManyRelationship
        - `data` ResourceIdentifier[], required
          - `type` string, required
          - `id` string, required
      - `duration_details` ToOneRelationship
        - `data` ResourceIdentifier, required
          - `type` string, required
          - `id` string, required
  - `included` IncludedResource[] — Resources requested through `include`, when available
    - `type` string, required
    - `id` string, required
    - `attributes` object, required
    - `relationships` object
  - `meta` unknown[], required — Empty JSON array returned for an Event item
    - unknown

## Other responses

- `400` — Invalid request body
- `401` — Unauthorized
- `403` — Forbidden - No permission to create Events
- `404` — Location, Team Member, or Service not found
- `409` — Team Member or Resource Instance is unavailable
- `422` — Request validation failed

---

[API](https://skmtc.net/alteg/apis/business-management.md) · [All operations](https://skmtc.net/alteg/apis/business-management/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/alteg/business-management/revisions/bc9cbcc9c5f1/schema)