---
title: "Handler Create Automation"
method: POST
path: "/money/automations"
---

# Handler Create Automation

`POST /money/automations`

## Request body

- AutomationsCreateAutomationInputJSON
  - `cadence_day_of_month` integer, nullable
  - `cadence_days_of_week` integer[], nullable
  - `cadence_frequency` 'daily' | 'weekly' | 'monthly' | 'once', required
  - `cadence_start_date` string
  - `cadence_time_of_day` string, required
  - `cadence_timezone` string, required
  - `condition_operator` 'above' | 'below', required
  - `condition_threshold` string, required
  - `denomination` 'usd' | 'units'
  - `destination_symbol` string, required
  - `name` string, required
  - `settlement_pathway` 'standard' | 'express'
  - `side` 'buy' | 'sell'
  - `skip_weekends` boolean
  - `source_symbol` string, required
  - `sweep_amount` string, required
  - `sweep_type` 'fixed' | 'percentage', required

## Response `200`

OK

- AutomationsSummary
  - `cadence_day_of_month` integer, nullable
  - `cadence_days_of_week` integer[], nullable, required
  - `cadence_frequency` 'daily' | 'weekly' | 'monthly' | 'once', required
  - `cadence_start_date` string
  - `cadence_time_of_day` string, required
  - `cadence_timezone` string, required
  - `condition_operator` 'above' | 'below', required
  - `condition_threshold` MoneyfmtMoneyAmountView, required
    - `float` number, double, required
    - `formatted` MoneyfmtFormattedMoneyAmountView, required
      - `compact` string, required
      - `currency_sign` string, required
      - `currency_sign_position` string, required
      - `full` string, required
    - `precise` string, required
    - `symbol` string, required
    - `zero` boolean, required
  - `created_ts` string, date-time, required
  - `denomination` 'usd' | 'units', required
  - `destination_symbol` string, required
  - `enabled` boolean, required
  - `id` string, required
  - `latest_run` AutomationsLatestRun
    - `skip_reason` 'condition_not_met' | 'non_positive_sweep_amount' | 'below_fund_minimum' | 'below_trade_minimum' | 'express_pathway_unavailable' | 'instant_pathway_unavailable' | 'price_unavailable', nullable
    - `started_ts` string, date-time, required
    - `status` 'pending' | 'completed' | 'failed' | 'skipped', required
  - `name` string, required
  - `schedule_state` 'scheduled' | 'spent'
  - `settlement_pathway` 'standard' | 'express', required
  - `side` 'buy' | 'sell', required
  - `skip_weekends` boolean, required
  - `source_symbol` string, required
  - `sweep_amount` MoneyfmtMoneyAmountView, required
    - `float` number, double, required
    - `formatted` MoneyfmtFormattedMoneyAmountView, required
      - `compact` string, required
      - `currency_sign` string, required
      - `currency_sign_position` string, required
      - `full` string, required
    - `precise` string, required
    - `symbol` string, required
    - `zero` boolean, required
  - `sweep_percentage` string
  - `sweep_type` 'fixed' | 'percentage', required
  - `updated_ts` string, date-time, required

## Other responses

- `default` — Error response.

## Changes

- **2026-09-01** `f2d9f80610d9` — 1 info
  - added the optional property `error/api_client_id` to the response with the `default` status
- **2026-08-26** `533de842b808` — 2 warning, 4 info
  - the `condition_threshold` request property's maxLength was set to `64`
  - the `sweep_amount` request property's maxLength was set to `64`
  - added the new optional request property `denomination`
  - added the new optional request property `skip_weekends`
  - …2 more
- **2026-08-25** `1b3f9dae384c` — 1 warning, 7 info
  - added the new `once` enum value to the `cadence_frequency` response property for the response status `200`
  - added the new optional request property `cadence_start_date`
  - added the new optional request property `side`
  - added the new `once` enum value to the request property `cadence_frequency`
  - …4 more
- **2026-08-24** `19fa7a7499bd` — 2 info
  - added the new optional request property `settlement_pathway`
  - added the required property `settlement_pathway` to the response with the `200` status
- **2026-08-06** `fe2041c5ba86` — 1 info
  - the `id` response's property pattern was changed from `^auto_[0-9a-hjkmnp-tv-z]{26}$` to `^auto_[0-7][0-9a-hjkmnp-tv-z]{25}$` for the status `200`

[Change history](https://skmtc.dev/stablesea/apis/stable-sea-backend/changes/money/automations/post.md)

---

[API](https://skmtc.dev/stablesea/apis/stable-sea-backend.md) · [All operations](https://skmtc.dev/stablesea/apis/stable-sea-backend/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/stablesea/stable-sea-backend/revisions/0a6aeb726c1f/schema)