---
title: "/:channel"
method: POST
path: "/bot/timers/{channel}"
tags: ["timers"]
---

# /:channel

`POST /bot/timers/{channel}`

## Request

- Base URL: `https://api.streamelements.com/kappa/v2`
- URL: `https://api.streamelements.com/kappa/v2/bot/timers/{channel}`
- Auth: one of:
  - HTTP bearer
  - OAuth 2
    - Authorization code: `https://api.streamelements.com/oauth2/authorize`
    - Token URL: `https://api.streamelements.com/oauth2/token`
  - HTTP bearer
- TypeScript: <https://skmtc.dev/streamelements/apis/se-api-docs/docs/bot/timers/:channel/post.ts> (a function with typed inputs; its response is checked against the schema)

Create a new timer

## Path parameters

- `channel` string, required

## Headers

- `Accept` string, required

## Request body

- Channelrequest1
  - `online` Online, required
    - `enabled` boolean, required
    - `interval` integer, required
  - `offline` Offline, required
    - `enabled` boolean, required
    - `interval` integer, required
  - `enabled` boolean, required
  - `chatLines` integer, required
  - `name` string, required
  - `message` string, required

## Response `201`

- BotCommand
  - `cooldown` Cooldown, required
    - `user` integer, required
    - `global` integer, required
  - `aliases` string[], required
  - `keywords` string[], required
  - `enabled` boolean, required
  - `enabledOnline` boolean, required
  - `enabledOffline` boolean, required
  - `hidden` boolean, required
  - `cost` integer, required
  - `type` string, required
  - `accessLevel` integer, required
  - `_id` string
  - `regex` string, required
  - `reply` string, required
  - `command` string, required
  - `channel` string, required
  - `createdAt` string
  - `updatedAt` string

## Other responses

- `409`: Conflict

## Changes

- **2022-08-19** `7ec3cd3b664e`: 8 breaking, 3 info
  - added the new required request property `chatLines`
  - added the new required request property `enabled`
  - added the new required request property `message`
  - added the new required request property `name`
  - …7 more
- **2021-02-22** `51e3df32da57`: 3 breaking
  - the response property `_id` became optional for the status `201`
  - the response property `createdAt` became optional for the status `201`
  - the response property `updatedAt` became optional for the status `201`
- **2021-02-07** `8c745ed2e9e4`: 11 warning
  - the optional response header `Access-Control-Allow-Credentials` removed for the status `201`
  - the optional response header `Access-Control-Expose-Headers` removed for the status `201`
  - the optional response header `ETag` removed for the status `201`
  - the optional response header `Server` removed for the status `201`
  - …7 more

[Operation history](https://skmtc.dev/streamelements/apis/se-api-docs/changes/bot/timers/:channel/post.md)

---

[API](https://skmtc.dev/streamelements/apis/se-api-docs.md) - [All operations](https://skmtc.dev/streamelements/apis/se-api-docs/llms.txt) - [OpenAPI document](https://skmtc.dev/streamelements/apis/se-api-docs/revisions/aa13169b9373?raw)