---
title: "Create Ticker"
method: POST
path: "/api/v1/admin/tickers"
tags: ["Admin APIs", "tickers"]
---

# Create Ticker

`POST /api/v1/admin/tickers`

## Request body

- TickerCreate
  - `message` string, required — Message content in Markdown format
  - `priority` integer — Priority level (higher numbers = higher priority)
  - `is_active` boolean — Whether the ticker should be shown (active/inactive)
  - `starts_at` string, date-time, nullable — Start time (ISO-8601), null = immediate
  - `ends_at` string, date-time, nullable — End time (ISO-8601), null = indefinite
  - `clients` string[], nullable — Optional list of client IDs to target

## Response `200`

Successful Response

- TickerResponse
  - `message` string, required — Message content in Markdown format
  - `priority` integer — Priority level (higher numbers = higher priority)
  - `is_active` boolean — Whether the ticker should be shown (active/inactive)
  - `starts_at` string, date-time, nullable — Start time (ISO-8601), null = immediate
  - `ends_at` string, date-time, nullable — End time (ISO-8601), null = indefinite
  - `id` string, uuid, required
  - `created_at` string, date-time, required
  - `updated_at` string, date-time, required
  - `created_by` string, nullable, required
  - `clients` string[], nullable — List of client IDs this ticker is assigned to

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/carbonarc/apis/carbon-arc-client-admin-api.md) · [All operations](https://skmtc.net/carbonarc/apis/carbon-arc-client-admin-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/carbonarc/carbon-arc-client-admin-api/revisions/a8ca30023371/schema)