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

# Create Event

`POST /locations/{location_id}/events`

## Request

- Base URL: `https://api.alteg.io/api/v2`
- URL: `https://api.alteg.io/api/v2/locations/{location_id}/events`
- Auth: HTTP bearer

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
  - `team_member_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
      - `deleted` boolean, required: Whether the Event is deleted (a deleted Event stays readable by ID)
      - `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

## Changes

- **2026-09-30** `0f9938a8b921`: 1 info
  - added the required property `data/attributes/deleted` to the response with the `201` status
- **2026-09-29** `a3a7f7158533`: 1 breaking, 1 warning, 1 info
  - added the new required request property `team_member_id`
  - removed the request property `staff_id`
  - response property `data/attributes/master_id` deprecated

[Operation history](https://skmtc.dev/alteg/apis/business-management/changes/locations/:location_id/events/post.md)

---

[API](https://skmtc.dev/alteg/apis/business-management.md) - [All operations](https://skmtc.dev/alteg/apis/business-management/llms.txt) - [OpenAPI document](https://skmtc.dev/alteg/apis/business-management/revisions/a2d63320b944?raw)
