---
title: "Create Automation"
method: POST
path: "/v1/automations"
tags: ["Automations"]
---

# Create Automation

`POST /v1/automations`

## Request

- Base URL: `https://api.oviond.com`
- URL: `https://api.oviond.com/v1/automations`
- Auth: one of:
  - HTTP bearer
  - HTTP bearer

Create a new automation for a report

## Request body

- CreateAutomationRequest
  - `parent_id` string, required: Report ID this automation belongs to
  - `name` string, required
  - `frequency` 'daily' | 'weekly' | 'monthly', required
  - `day` string
  - `hours` string, required
  - `minutes` string, required
  - `timezone` string, required
  - `time_format` 'AM' | 'PM'
  - `recipients` string[], required
  - `template_id` string, required: Saved email template id, or the literal "custom" to save a new template from the custom payload
  - `sender_id` string, required: Saved email sender id
  - `custom` object: Required when template_id === "custom" — saved as a new named email template (name + subject + message)
    - `name` string, required
    - `subject` string, required
    - `message` string, required
    - `button_text` string, nullable
    - `button_top` boolean
  - `date_text` 'Today' | 'Yesterday' | 'Last 7 Days' | 'Last 30 Days' | 'Last 60 Days' | 'Last Month' | 'This Month' | 'Last 2 Months' | 'Last 3 Months' | 'Last 12 Months' | 'This Year' | 'Last Year', required

## Response `201`

Automation created

- CreateAutomationResponse
  - `success` true, required
  - `data` object, required
    - `automation_id` string, required
    - `template_id` string, required

## Other responses

- `404`: Parent report not found

---

[API](https://skmtc.dev/oviond/apis/oviond-backend-api.md) · [All operations](https://skmtc.dev/oviond/apis/oviond-backend-api/llms.txt) · [OpenAPI document](https://skmtc.dev/oviond/apis/oviond-backend-api/revisions/4cb0a07daf41?raw)