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

# Create a Schedule

`POST /v1/schedules/`

## Headers

- `Authorization` string — User access token
- `Content-Type` 'application/json'

## Request body

- object
  - `name` string, required — Name of the schedule
  - `referenceTz` string, required — [Time zone identifier](https://en.wikipedia.org/wiki/List_of_tz_database_time_zones) for the schedule
  - `schedule` object[], required — The different schedules that will trigger an event
    - `daysOfWeek` integer[], required — Days of the week the schedule times are active where 0 represents Sunday and 6 represents Saturday.
    - `times` object[], required — The time segments throughout the day represented in seconds that the schedule is active.
      - `startTime` integer, required
      - `endTime` integer, required

## Response `201`

Returns the created schedule

- object
  - `id` string, required — Unique identifier for the schedule
  - `name` string, required — Name of the schedule
  - `referenceTz` string, required — [Time zone identifier](https://en.wikipedia.org/wiki/List_of_tz_database_time_zones) for the schedule
  - `schedule` object[], required — The different schedules that will trigger an event
    - `daysOfWeek` integer[], required — Days of the week the schedule times are active where 0 represents Sunday and 6 represents Saturday.
    - `times` object[], required — The time segments throughout the day represented in seconds that the schedule is active.
      - `startTime` integer, required
      - `endTime` integer, required

## Other responses

- `400` — Returns a list of validation errors

---

[API](https://skmtc.net/bouncie/apis/bouncie-api.md) · [All operations](https://skmtc.net/bouncie/apis/bouncie-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/bouncie/bouncie-api/revisions/7b4fc4cc0eb9/schema)