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

# Create automation

`POST /automations`

## Request

- Base URL: `https://api.tinysend.com/v1`
- URL: `https://api.tinysend.com/v1/automations`
- Auth: HTTP bearer

## Request body

- CreateAutomation
  - `project_id` string: Defaults to the caller's project when omitted.
  - `type` 'quality' | 'triage' | 'auto_reply' | 'digest' | 'domain_health' | 'spam_guard' | 'audience' | 'extract' | 'otp' | 'summarizer' | 'custom', required
  - `entity_type` 'mailbox' | 'list' | 'project', required
  - `entity_id` string, required
  - `enabled` boolean
  - `name` string
  - `model` string
  - `system_prompt` string
  - `tool_permissions` object
  - `schedule` string
  - `skills` string[]
  - `config` object
  - `allowed_domains` string[]

## Response `201`

Created

- Automation
  - `id` string, required
  - `project_id` string, required
  - `type` string, required
  - `entity_type` string, required
  - `entity_id` string, required
  - `enabled` boolean, required
  - `name` string, nullable, required
  - `model` string, nullable, required
  - `system_prompt` string, nullable, required
  - `tool_permissions` object, nullable, required
  - `schedule` string, nullable, required
  - `skills` string[], nullable, required
  - `config` object, nullable, required
  - `allowed_domains` string[], nullable, required
  - `created_at` string, required
  - `updated_at` string, required

## Other responses

- `404`: Not found

---

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