---
title: "Create Report Template"
method: POST
path: "/reports/templates"
tags: ["Reports"]
---

# Create Report Template

`POST /reports/templates`

## Request

- Base URL: `https://api.rebrandly.com/v1`
- URL: `https://api.rebrandly.com/v1/reports/templates`
- Auth: API key in header `apikey`

Create a new report template for scheduled or ad-hoc reports.

**Requires:**
- Feature: `reports.custom`

**Blocked by:** Revoked workspace or domain.

## Headers

- `Workspace` string
- `apikey` string, required

## Request body

- object
  - `name` string, required: Template name
  - `description` string: Template description
  - `query` object, required: Query definition for the report
  - `subscriptions` object[]: Email subscriptions for the report

## Response `200`

Template created

- ReportTemplate: Custom report template
  - `id` string, required: Template public ID
  - `name` string, required: Template name
  - `description` string: Template description
  - `query` object: Query definition for the report
  - `schedule` object: Schedule configuration
    - `id` string
    - `frequency` 'daily' | 'weekly' | 'monthly'
    - `active` boolean
    - `nextRun` string, date-time
  - `lastExecutionTimestamp` string, date-time: Last time the report was executed
  - `createdAt` string, date-time
  - `updatedAt` string, date-time

## Other responses

- `403`: Feature not available or insufficient permissions

---

[API](https://skmtc.dev/rebrandly/apis/rebrandly-api.md) - [All operations](https://skmtc.dev/rebrandly/apis/rebrandly-api/llms.txt) - [OpenAPI document](https://skmtc.dev/rebrandly/apis/rebrandly-api/revisions/b098bf9fb684?raw)