Skip to main content
POST
Create an automation

Authorizations

Authorization
string
header
required

Motion API key (motion_ prefix), authenticated as its owner. Account and engine permissions still apply.

Body

application/json

Creates an enabled automation. Defaults: GVA standard, memory {rememberProcessedItems:true,includePreviousRuns:5,compactAfterRuns:20}, no connectors, one concurrent run and four runs per hour. Creation is not idempotent; do not blindly repeat a request after a lost response.

name
string
required
Required string length: 1 - 160
prompt
string
required

Self-contained instructions used for every future invocation.

Required string length: 1 - 20000
trigger
object
required

Match platform to trigger type. Discover environment availability with GET /automations/capabilities.

memory
object
connectorPolicy
object

Uses existing connected accounts and permissions; this request cannot connect an account or grant access.

maxConcurrentRuns
integer
default:1
Required range: 1 <= x <= 10
maxRunsPerHour
integer
default:4
Required range: 1 <= x <= 100
execution
object

Supply engine or effort. Engine changes use the new engine default when effort is omitted.

outputKind
enum<string>
default:video
Available options:
video,
text,
auto

Response

Success

automation
object
required

Owner-scoped read view. Read responses can include additional saved context and history. Use the dedicated run-history endpoint for pagination. Read fields are not accepted as write inputs.