# Automations API > The automations resource exposes Mailrith workflow definitions for tools that create or synchronize automations outside the app. This guide explains what automations can affect, how to use the public schema, and what to review before you trust a generated workflow. - Human page: https://mailrith.com/developers/automations - Markdown page: https://mailrith.com/developers/automations.md - Category: API Resources - Reading time: 7 min read - Last updated: 2026-06-13 - Related keywords: Automations API, Automations API developer docs, API Resources, API Resources developer docs, Mailrith developer docs, Mailrith public API, Manage Automation Definitions, Endpoint Overview, Automation Review Checklist, Sequences API, Magic Links API, API Reference ## AI Agent Notes - Use this page as implementation guidance, then validate exact endpoint fields against the OpenAPI document. - Keep API keys server-side and workspace-scoped unless a guide explicitly says otherwise. - Do not invent privacy, consent, or lawful-basis evidence. Send only fields that appear in the OpenAPI schema for the endpoint you are using. ## What this guide covers Manage automation definitions with triggers, branches, actions, conditions, and review safeguards. ## Manage Automation Definitions Automations are rule-based workflows that react to subscriber activity and perform actions. Depending on the definition, automations can apply tags, change subscriber state, start or stop sequences, branch based on conditions, and call external systems. The automations API exposes the automation control plane for integrations that need to migrate, inspect, create, or synchronize workflow definitions outside the app. Automation changes can have a large impact because automations may run automatically after a trigger. Treat automation writes as high-impact changes and include review steps in your integration. 1. List existing automations before creating or updating workflow definitions. 2. Build the automation definition from the public schema, not from internal app state. 3. Validate every referenced tag, custom field, sequence, magic link, delivery connection, and webhook URL before sending the request. 4. Create or update the automation in an inactive or reviewable state when your workflow supports that state. 5. Ask a user to review the canvas in [Automations](https://mailrith.com/docs/automations.md). 6. Test with internal subscribers before allowing the automation to process real subscriber activity. 7. Require explicit approval before activating AI-generated or externally generated automations. - List automations to audit existing workflows before a migration or cleanup. - Create automations from a trusted source definition, not from guessed app state. - Update automations carefully because small changes to branches or conditions can change which subscribers receive which actions. - Delete automations only after you confirm that the workflow is no longer needed. ## Endpoint Overview `GET /v1/automations` lists automation definitions. Item endpoints let your integration inspect, update, or delete one automation. `POST /v1/automations` creates an automation definition using the public schema. The schema is intentionally structured so external callers can build definitions without depending on the app's internal React state. Use the generated API reference for exact trigger, condition, path, and action shapes. Validate definitions before sending them to Mailrith. Then test the resulting workflow in the app before relying on it. Related OpenAPI operation groups: - Automations ## Automation Review Checklist A valid JSON payload is not enough to make an automation safe. The workflow also must make sense for the subscribers, the triggering event, and the actions the automation performs. Before activating or relying on an automation created by an integration, review the workflow in Mailrith as a user would see it. - Confirm that the trigger starts only for the intended subscribers. - Confirm that every branch condition has a clear business meaning. - Confirm that every tag, sequence, webhook, or status action points to the intended resource. - Confirm that the workflow has a safe path for subscribers who do not match optional conditions. - Keep live-send or destructive actions behind explicit review when automations are generated by AI or external tools. ## Related Guides - [Sequences API](https://mailrith.com/developers/sequences.md): The sequences resource lets external systems prepare, migrate, or synchronize time-based email series. This guide explains how to plan sequence definitions, when to update or delete sequences, and what to check before migrated journeys reach real subscribers. - [Magic Links API](https://mailrith.com/developers/magic-links.md): The magic links resource lets external tools create and maintain subscriber action links. This guide explains where to use magic links, how to match each action with the correct destination, and how to test links before live campaigns. - [API Reference](https://mailrith.com/developers/api-reference.md): The full API reference is generated from the same public contract used by the API worker and SDK tooling. Use the API reference to find exact paths, methods, parameters, request schemas, response schemas, operation IDs, and the downloadable OpenAPI document.