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

# Create an automation

`POST /automations`

## Request body

- object
  - `title` string, required
  - `trigger_type` 'apply_list' | 'open_campaign' | 'click_campaign'
  - `trigger_list_id` integer — Required when trigger_type is apply_list
  - `trigger_campaign_id` integer — Required when trigger_type is open_campaign or click_campaign
  - `active` boolean

## Response `201`

Automation created

- Automation
  - `id` integer
  - `user_id` integer
  - `title` string
  - `active` boolean
  - `created_at` string, date-time
  - `updated_at` string, date-time
  - `automation_triggers` AutomationTrigger[]
    - `id` integer
    - `automation_id` integer
    - `type` 'apply_list' | 'open_campaign' | 'click_campaign'
    - `list_id` integer, nullable
    - `campaign_id` integer, nullable
    - `created_at` string, date-time
    - `updated_at` string, date-time
  - `automation_items` AutomationItem[]
    - `id` integer
    - `automation_id` integer
    - `campaign_id` integer
    - `delay_hours` integer
    - `send_order` integer
    - `campaign` Campaign
      - `id` integer
      - `title` string, required
      - `subject` string, required
      - `preview_text` string, nullable — Inbox preview snippet shown beneath the subject line in most email clients.
      - `html` string, required
      - `from_name` string, required
      - `from_email` string, email, required
      - `scheduled_at` string, date-time, nullable
      - `sent_at` string, date-time, nullable
      - `timezone` string
      - `created_at` string, date-time
      - `updated_at` string, date-time
    - `created_at` string, date-time
    - `updated_at` string, date-time

## Other responses

- `402` — Payment Required (API access requires a paid plan)
- `403` — Forbidden
- `422` — Validation error

---

[API](https://skmtc.net/sendfox/apis/sendfox-api.md) · [All operations](https://skmtc.net/sendfox/apis/sendfox-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/sendfox/sendfox-api/revisions/ea591a7644e7/schema)