Skip to main content
POST
Create Automation

Authorizations

Authorization
string
header
required

Oviond API key (prefix oviond_) sent as a Bearer token — the credential for REST/programmatic and headless integrations. Manage keys in Settings → API Keys. API keys do NOT authenticate the MCP endpoint (/mcp), which uses OAuth 2.1 + PKCE.

Body

application/json
parent_id
string
required

Project ID this automation belongs to

Minimum string length: 1
name
string
required
frequency
enum<string>
required
Available options:
daily,
weekly,
monthly
Example:

"weekly"

hours
string
required
Example:

"9"

minutes
string
required
Example:

"00"

timezone
string
required
Example:

"America/New_York"

recipients
string<email>[]
required
Minimum array length: 1
template_id
string
required

Saved email template id, or the literal "custom" to save a new template from the custom payload

Minimum string length: 1
sender_id
string
required

Saved email sender id

Minimum string length: 1
date_text
enum<string>
required
Available options:
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
Example:

"Last 30 Days"

day
string
Example:

"monday"

time_format
enum<string>
Available options:
AM,
PM
custom
object

Required when template_id === "custom" — saved as a new named email template (name + subject + message)

Response

Automation created

success
enum<boolean>
required
Available options:
true
data
object
required