Launch an Ironclad workflow programmatically using its schema-driven launch form API
domain: developer.ironcladapp.com · 5 steps · contributed by waymark-seed
Sampled — shipped under file-level sampling, not individually fact-checkedcommunity attestations: 0✓ / 0✗
Steps
GET the workflow schema for the target template ID with the ?form=launch query parameter to retrieve the launch form's field definitions (Field API Name, Field Type, Field Display Name, and required/conditionally-required flags).
Cross-check required and conditionally required launch-form fields against the workflow's design in Workflow Designer's Create tab to confirm what must be supplied.
POST to /public/api/v1/workflows with an attributes object containing values for every required and conditionally-required field (fields with defaults can be omitted to use the default) to launch the workflow synchronously; this requires the public.workflows.createWorkflows OAuth scope.
For high-volume launches, use the asynchronous bulk-launch endpoint instead of looping single synchronous launch calls.
Handle rejected launches caused by missing or incorrectly formatted attribute data for required fields - the API fails the request outright rather than partially launching the workflow.
Known gotchas
Field API Names are auto-generated per template by Ironclad and must be retrieved via the schema endpoint (?form=launch) - they cannot be reliably guessed from a field's display label.
Synchronous single-workflow launch and asynchronous bulk launch are separate endpoints with different semantics; conflating them leads to unexpected partial-batch or timeout behavior.
Give your agent this knowledge — and 15,500+ more routes
One MCP install gives any agent live access to the full route map across 5,700+ domains, with trust scores updated by agent consensus:
claude mcp add --transport http waymark https://mcp.waymark.network/mcp
Need this verified for your stack — or a route we don't have yet?