Automations
Run an automation now
Changed onSchedule automations only; channel automations require a real source event. New invocations open a new Motion chat and may use credits. Send no body. Requires motion:automations:write for OAuth tokens. API keys use the owner account permissions. Automation access must be enabled for the account and environment. See /guides/automations. Automations execute only with GVA; Claude supports reads, pause, and delete only.
post/automations/{automation_id}/run
Request
- Base URLhttps://api.motion.so/api/motion
- Auth
- HTTP bearer
- or OAuth 2Authorization codehttps://mcp.motion.so/oauth/authorizeToken URLhttps://mcp.motion.so/oauth/tokenScopesmotion:automations:write
- TypeScriptA function with typed inputs. Its response is checked against the schema.
Path parameters
automation_idstring required
ID returned by list or create.
Headers
Idempotency-Keystring uuid required
New UUID for each intentional run. Reuse the same UUID after a lost response to avoid duplicate work.
Response
Existing invocation returned for a reused UUID.
Changes
- info
endpoint added
- info