---
title: "Create a saved analytics report from a Hive template for the requested accounts and dates. For explicit dates, always use dateFrom and dateTo as YYYY-MM-DD, never calculate epoch timestamps. Save the person’s summary in description and coverage gaps in internalNotes."
method: POST
path: "/api/v1/tools/create_report"
---

# Create a saved analytics report from a Hive template for the requested accounts and dates. For explicit dates, always use dateFrom and dateTo as YYYY-MM-DD, never calculate epoch timestamps. Save the person’s summary in description and coverage gaps in internalNotes.

`POST /api/v1/tools/create_report`

## Request

- Base URL: `https://hivepublish.com`
- URL: `https://hivepublish.com/api/v1/tools/create_report`
- Auth: HTTP bearer

## Headers

- `Idempotency-Key` string, required

## Request body

- object
  - `title` string, required
  - `templateKey` 'cross-network' | 'network' | 'post-performance' | 'audience-growth' | 'competitor' | 'listening' | 'campaign' | 'inbox-productivity' | 'executive-summary'
  - `dateFrom` string: Inclusive report start as YYYY-MM-DD. Use with dateTo.
  - `dateTo` string: Inclusive report end as YYYY-MM-DD. Use with dateFrom.
  - `datePeriod` object
    - `preset` 'thisMonth' | 'lastMonth' | 'thisWeek' | 'lastWeek' | 'last30' | 'custom', required
    - `from` number: Custom start in epoch milliseconds.
    - `to` number: Custom inclusive end in epoch milliseconds.
  - `description` string
  - `internalNotes` string
  - `channelIds` string[]

## Response `200`

Tool result

- ToolResult
  - `data` unknown, required
  - `meta` object, required
    - `tool` string
    - `workspaceId` string, uuid

## Other responses

- `400`: Invalid input
- `401`: Missing or invalid credential
- `403`: Missing workspace scope, role permission, or plan entitlement
- `409`: Idempotency conflict, replay, or request still in progress
- `429`: Rate limit exceeded

---

[API](https://skmtc.dev/hivepublish/apis/hive-developer-api.md) · [All operations](https://skmtc.dev/hivepublish/apis/hive-developer-api/llms.txt) · [OpenAPI document](https://skmtc.dev/hivepublish/apis/hive-developer-api/revisions/b440c763583e?raw)