Save an automation from a drafted schema

post

https://{youraccountname}.api-us1.com/api/3/ai/automations/build

Persists the automation described by the schema JSON string from a prior draft call. A repeated sessionId returns the existing series. A missing sessionId, or a session with no prior build, still creates one. Answers 403 when the API user may not manage automations or when entitlements block triggers or actions in the proposal, and 500 when the builder or model fails.

Body Params

Workflow document from a prior draft call, plus optional build options.

schema

string

required

JSON string of the workflow document returned from the draft call (must include workflow.actions).

labelId

integer | null

Folder label id when the automation should be filed under a label.

failOnError

boolean | null

When true, stop on the first blocking build error.

sessionId

string | null

Optional automation agent session identifier for telemetry and async follow-up work. A repeated value returns the existing series. Omitting it, or a value with no prior build, still creates one.

skipCampaignGeneration

boolean

When true, skip LLM campaign generation for send blocks.

externalEmailWriter

boolean

When true, return send step to block pairings for an external email writer.

Responses

200The saved automation, including series id and any scrubbed capabilities.

403The API user may not manage automations, or the account lacks entitlements for triggers or actions in the proposal.

500The schema builder could not persist the automation.