# 자동화

> Owner-built automations on triggers, with conditions, branches, delays, retries, custom triggers and HTTP actions.

> Markdown version of https://kanorio.com/ko/developers/products/automation. Append `.md` to any developer docs URL for this format. Index: https://kanorio.com/llms.txt · MCP: https://app.kanorio.com/api/mcp
>
> Translated from the English original: https://kanorio.com/en/developers/products/automation.md

Status: **Available**

자동화는 주문 결제, 양식 제출, 특정 날짜 도래 또는 자체 시스템의 이벤트 보고와 같은 특정 상황이 발생할 때 단계를 실행합니다. 이메일 전송은 수많은 작업 중 하나일 뿐입니다.

## 핵심 객체

- **트리거 및 작업:** 각 트리거 데이터와 각 작업 입력에 대한 JSON 스키마가 포함된 카탈로그입니다.
- **자동화:** 관리 화면이나 API를 통해 구축되는 조건, 분기, 지연 및 속도 제한입니다.
- **실행:** 재시도, 실패 세부 정보 및 재실행 옵션이 포함된 단계별 실행 내역입니다.
- **사용자 지정 트리거:** `POST /sites/{id}/automations/events`를 사용하여 자체 이벤트를 보고하고 자동화를 시작할 수 있습니다.

## API 활용 방법

- Management API를 사용하여 카탈로그를 읽고, 자동화를 생성·편집·테스트하며, 실행 내역을 확인하고 재시도할 수 있습니다.
- `automations.run.failed` Webhook을 통해 실행 실패 시 알림을 받을 수 있습니다.

## What the APIs expose

| Capability | Status | API | Elements | Hosted site | Webhooks |
| --- | --- | --- | --- | --- | --- |
| Automation engine: trigger/action catalog, owner-built flows, per-step runs, custom triggers | Available | Management API (REST/MCP) `automations.catalog.get`, `automations.templates.list`, `automations.flows.*` (list/get/validate/create/update/set_status/archive/delete/test), `automations.runs.*` (list/get/rerun), `automations.events.report`/`cancel`, `automations.triggers.*`, `automations.secrets.*`; preinstalled toggles via `automations.list`/`set_action_enabled`; signed inbound endpoint `POST /api/webhooks/automations/<token>` (Standard Webhooks) | — | `/automations`, `/automations/settings` | Every trigger in the catalog is also a subscribable webhook event; custom triggers accept signed inbound webhooks (planned) |

## API reference

- Management API: [Automations](https://kanorio.com/en/developers/management-api/automations) (27 operations)

## Webhook events

- `automations.run.failed`: Fired when a run of an owner-built automation ends in FAILED after retries (compensation already applied). Not fired for test runs or platform-default automations; at most once per automation revision every 30 days.
- `automations.flow.paused`: Fired when Kanorio turns an owner-built automation off automatically because its current revision ran more than 20 times in the past 7 days and 95% or more of those runs failed.

Payloads: https://kanorio.com/en/developers/webhooks/events