---
title: "Create a report schedule (admin accounts, v1)"
method: POST
path: "/api/v1/reports/schedules"
tags: ["Custom Reports"]
---

# Create a report schedule (admin accounts, v1)

`POST /api/v1/reports/schedules`

## Request

- Base URL: `https://tradingstrategies.work`
- URL: `https://tradingstrategies.work/api/v1/reports/schedules`
- Auth: HTTP bearer

Same definition as a quote (strategy, universeTier, interval, periodLabel, filterConfig, strategyParams) plus cadence weekly or monthly and optional firstRunAt (ISO). Validated like a purchase incl. one universe resolution (n_viable > 0). v1: creation is limited to admin accounts — plan binding is pending. [API Pro tier + admin]

## Request body

- object
  - `strategy` string, required
  - `universeTier` 'top-10' | 'top-50' | 'top-100' | 'top-250' | 'custom', required
  - `customPairs` string[]
  - `interval` '1d' | '1w' | '1M', required
  - `periodLabel` 'last-2-years' | 'last-5-years' | 'since-2020' | 'maximum', required
  - `cadence` 'weekly' | 'monthly', required
  - `firstRunAt` string, date-time: Default: next runner tick.
  - `email` string: Recipient. Default: profile email.
  - `filterConfig` object
  - `strategyParams` object

## Response `200`

Created schedule + preview (n_viable, first_run_at, second_run_at).

## Other responses

- `400`: Invalid input — fehlt Pflichtfeld oder Wert außerhalb des erlaubten Bereichs.
- `401`: Unauthenticated — kein gültiger Bearer-Token im Authorization-Header.
- `403`: Tier-Insufficient — Endpoint braucht höheren API-Tier. Response enthält upgrade_url.
- `404`: Not-Found — Resource existiert nicht oder gehört nicht dem aktuellen User.
- `429`: Rate-Limit überschritten — Tier-Quota (hourly/daily) oder Per-Endpoint-Quota erreicht. Retry-After-Header gesetzt.
- `500`: Internal Error.
- `503`: Upstream-Failure — Datenquelle nicht erreichbar (Binance, EODHD, etc.).

---

[API](https://skmtc.dev/tradingstrategies/apis/backtesting-arena-public-api.md) · [All operations](https://skmtc.dev/tradingstrategies/apis/backtesting-arena-public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/tradingstrategies/apis/backtesting-arena-public-api/revisions/f82e8d6eecd7?raw)