---
title: "Create scheduled report"
method: POST
path: "/scheduled-reports"
tags: ["Scheduled Reports"]
---

# Create scheduled report

`POST /scheduled-reports`

Creates a new scheduled report.

## Request body

- V4ScheduledReportCreateRequest
  - `report_name` string, required
  - `send_at` string, required — UTC `HH:MM`, aligned to 30-min slots, `"00:00"` to `"23:30"`.
  - `included_range_days` 1 | 3 | 7, required
  - `status` 'draft' | 'active', required
  - `environment` 'sandbox' | 'production', required
  - `destinations` V4ScheduledReportDestination[], required
    - `type` string, required — Destination kind. Currently always `target_integration`.
    - `id` string, required — Destination identifier within the given type.
    - `label` string — Human-readable label — present on read, ignored on write.

## Response `201`

Scheduled report created.

- V4ScheduledReport — A scheduled report configuration. Delivers an analytics snapshot to the listed destinations once per day at `send_at` UTC, covering the prior `included_range_days` days of data.
  - `object` string, required
  - `id` string, required — Report identifier.
  - `url` string, required
  - `report_name` string, required — Human-readable name, 1-255 chars.
  - `send_at` string, required — UTC time-of-day for the daily delivery, `HH:MM` format, aligned to 30-minute slots. Valid values range from `"00:00"` to `"23:30"`.
  - `included_range_days` 1 | 3 | 7, required — Coverage window in whole days — one of 1, 3, 7.
  - `status` 'draft' | 'active', required — `draft` — paused, no deliveries. `active` — enqueued for delivery at each `send_at`.
  - `environment` 'sandbox' | 'production', required
  - `runs` integer, required — Number of deliveries completed so far.
  - `destinations` V4ScheduledReportDestination[], required
    - `type` string, required — Destination kind. Currently always `target_integration`.
    - `id` string, required — Destination identifier within the given type.
    - `label` string — Human-readable label — present on read, ignored on write.
  - `created_at` string, date-time, required
  - `updated_at` string, date-time, required

## Other responses

- `400` — Invalid request
- `401` — Unauthorized
- `403` — Feature not available
- `404` — Not found
- `415` — Unsupported Content-Type
- `429` — Rate limited
- `500` — Internal error
- `502` — Storage error
- `504` — Upstream timeout

---

[API](https://skmtc.net/qonversion/apis/qonversion-rest-api-v4.md) · [All operations](https://skmtc.net/qonversion/apis/qonversion-rest-api-v4/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/qonversion/qonversion-rest-api-v4/versions/e3f72cf8951c/schema)