---
title: "Create a schedule"
method: POST
path: "/schedules"
tags: ["Schedules"]
---

# Create a schedule

`POST /schedules`

Creates a new schedule. In hosted mode, new schedules receive a Pro trial period. The subdomain is automatically generated from the schedule name.

## Request body

- object
  - `name` string, required — Name of the schedule
  - `type` 'venue' | 'talent' | 'curator', required — Type of schedule
  - `email` string, email — Contact email for the schedule
  - `description` string — Description of the schedule (supports markdown)
  - `short_description` string — Short description of the schedule (plain text, max 200 characters)
  - `timezone` string — IANA timezone identifier
  - `language_code` 'en' | 'es' | 'de' | 'fr' | 'it' | 'pt' | 'he' | 'nl' | 'ar' | 'et' | 'ru' — Language code for the schedule
  - `website` string — Website URL for the schedule
  - `address1` string — Street address (primarily for venue type)
  - `city` string — City (primarily for venue type)
  - `state` string — State or province (primarily for venue type)
  - `postal_code` string — Postal or ZIP code (primarily for venue type)
  - `country_code` string — Country code (primarily for venue type)

## Response `201`

Schedule created successfully

- object
  - `data` Schedule
    - `id` string — Encoded schedule ID
    - `subdomain` string — Unique subdomain identifier for the schedule
    - `url` string, uri — Public URL of the schedule
    - `type` 'venue' | 'talent' | 'curator' — Type of schedule
    - `name` string — Display name of the schedule
    - `email` string, email, nullable — Contact email
    - `phone` string, nullable — Contact phone number
    - `website` string, nullable — Website URL
    - `description` string, nullable — Schedule description (may contain markdown)
    - `short_description` string, nullable — Short description of the schedule (plain text, max 200 characters)
    - `timezone` string, nullable — IANA timezone identifier
    - `language_code` string, nullable — Language code
    - `profile_image_url` string, uri, nullable — URL of the schedule's profile image
    - `address1` string, nullable — Street address
    - `city` string, nullable — City
    - `state` string, nullable — State or province
    - `postal_code` string, nullable — Postal or ZIP code
    - `country_code` string, nullable — Country code
    - `created_at` string, date-time, nullable — ISO 8601 creation timestamp
    - `updated_at` string, date-time, nullable — ISO 8601 last update timestamp
    - `groups` Group[] — Sub-schedules belonging to this schedule
      - `id` string — Encoded sub-schedule ID
      - `name` string — Sub-schedule name
      - `slug` string — URL-friendly slug
      - `color` string, nullable — Color associated with this sub-schedule

## Other responses

- `401` — Missing or invalid API key
- `422` — Validation error

## Changes

- **2026-02-17** `c1e54e26b0db` — 2 info
  - added the optional property `data/profile_image_url` to the response with the `201` status
  - added the optional property `data/updated_at` to the response with the `201` status
- **2026-02-14** `6b8e1dddb570` — 1 info
  - added the new `ru` enum value to the request property `language_code`
- **2026-02-12** `98078a07fd7a` — 2 info
  - added the new optional request property `short_description`
  - added the optional property `data/short_description` to the response with the `201` status
- **2026-02-11** `e24c8532211b` — 1 info
  - api operation id `create_schedule` was added
- **2026-02-11** `36ccba39bc4d` — 1 breaking, 4 warning, 1 info
  - removed the enum value `ru` of the request property `language_code`
  - removed the request property `short_description`
  - removed the optional property `data/profile_image_url` from the response with the `201` status
  - removed the optional property `data/short_description` from the response with the `201` status
  - …2 more

[Change history](https://skmtc.dev/eventschedule/apis/event-schedule-api/changes/schedules/post.md)

---

[API](https://skmtc.dev/eventschedule/apis/event-schedule-api.md) · [All operations](https://skmtc.dev/eventschedule/apis/event-schedule-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/eventschedule/event-schedule-api/revisions/fc24d7d227c4/schema)