Skip to main content

Create a workflow from a YAML spec

POST 
/v1/workflows

Create a workflow from a YAML spec.

The spec is compiled and validated first, then saved through the same path the visual builder uses — flush, prune, trigger registration — so the result shows up in the builder and runs identically to a workflow built by hand. Optional name and description override what the spec declares.

The workflow is created as a draft: activation is a separate, explicit call, so nothing authored through the API starts firing on its own. Requires the workflows:author scope.

Request​

Responses​

Successful Response

Last updated on