Process Street icon

Process Street

Interact with the Process Street API

Actions5

Workflow Run → Create

AI-generated

Summary

Create a named Process Street workflow run with optional metadata, form values, and file uploads. Optionally search first and return the first matching run instead of creating one.

Inputs

  • workflowId (required) — Required workflow template to run; choose from the loaded list or provide its ID using an expression.
  • name (required) — Required name for the new run.
  • searchBeforeCreate — Defaults to false. Searches using the workflow ID and run name, returning the first result from the first page. No exact-name check is performed locally. When a result is found, metadata and form values are not applied.
  • additionalFields — Optional dueDate and shared settings. A nonempty due date must be valid and more than 24 hours in the future.
  • formFields — Optional values for fields loaded from the selected workflow. Null, undefined, and empty-string values are skipped; other values are converted to strings. File and MultiFile fields accept a download URL whose contents are uploaded after creation. Multi-select fields use the separate selector; unsupported email, subtask, subchecklist, and table fields are excluded.
  • multiSelectValues — Optional checklist or multi-select choices, grouped by field, loaded from the selected workflow and applied after creation.

Output shape

One JSON item per input item containing the creation API response or the first existing run found.

The creation response is returned unchanged and may contain a nested workflowRun object; it is not refreshed after form updates. Field failures can occur after the run is created, without rollback. With Continue On Fail enabled, these failures add formFieldError to the run object; other failures return an error object.

Links

Discussion