---
title: "Create Digest"
method: POST
path: "/api/v1/reports/digests"
tags: ["reports"]
---

# Create Digest

`POST /api/v1/reports/digests`

Create a digest. Requires `can_create_reports` since a digest is
effectively a scheduled deliverable — same gate as a schedule.

## Headers

- `authorization` string, nullable
- `X-API-Key` string, nullable

## Request body

- DigestCreate
  - `name` string, required
  - `cron` string, required
  - `timezone` string
  - `format` string
  - `report_ids` integer[], required
  - `recipient_user_ids` integer[]

## Response `201`

Successful Response

- DigestOut
  - `id` integer, required
  - `name` string, required
  - `owner_id` integer, required
  - `schedule_cron` string, required
  - `timezone` string, required
  - `format` string, required
  - `report_ids` integer[], required
  - `recipient_user_ids` integer[], required
  - `is_active` boolean, required
  - `next_run_at` string, date-time, nullable
  - `last_run_at` string, date-time, nullable
  - `created_at` string, date-time, nullable
  - `updated_at` string, date-time, nullable

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/ninjavan/apis/salesforce-sales-cloud-replacement.md) · [All operations](https://skmtc.net/ninjavan/apis/salesforce-sales-cloud-replacement/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/ninjavan/salesforce-sales-cloud-replacement/revisions/fd3a41a6260b/schema)