Create a workflow

Creates a workflow from a trigger and a set of blocks. Create it disabled and enable it once the automation graph is complete. Returns the created workflow.

Authorization

Authorization<token>

API key authentication. Send your key in the Authorization header as: api-key <your-api-key>.

In: header

Path Parameters

workspace*string

The workspace slug — the {slug} segment of your Clarify workspace URL.

Query Parameters

silent?boolean

When true, suppresses in-app and Slack notifications for this mutation and batches its live updates, so open views can lag by up to 20 seconds.

Header Parameters

clarify-version?string

The API version for this request. Send 2026-11 to get the behavior documented here. Omit it to use your API key's version, which this header can raise but not lower.

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

data*

The resource to create.

Response Body

`application/json`

curl -X POST "https://example.com/workspaces/string/workflows" \  -H "clarify-version: 2026-11" \  -H "Content-Type: application/json" \  -d '{    "data": {      "type": "workflow",      "attributes": {        "name": "Create a task for every new deal",        "description": "When a deal is created, add a follow-up task for the owner.",        "enabled": false,        "exits": {},        "run_limits": {},        "type": "workflow",        "trigger": {          "_id": "trigger",          "plugin_id": "on:clarify:create:record",          "filters": [],          "input": {            "entity": "deal"          },          "prev": null,          "next": "create_task"        },        "blocks": {          "create_task": {            "_id": "create_task",            "plugin_id": "clarify:create:record",            "filters": [],            "input": {              "entity": "task",              "attributes": {                "name": "Follow up on new deal"              }            },            "prev": "trigger",            "next": null          }        }      }    }  }'

{  "data": {    "type": "workflow",    "id": "f2a4c6e8-0b1d-4e3f-8a5c-7d9e1f3a5b7c",    "attributes": {      "_id": "f2a4c6e8-0b1d-4e3f-8a5c-7d9e1f3a5b7c",      "name": "Create a task for every new deal",      "description": "When a deal is created, add a follow-up task for the owner.",      "enabled": true,      "type": "workflow",      "published_at": "2026-01-15T09:30:00.000Z",      "trigger": {        "_id": "trigger",        "plugin_id": "on:clarify:create:record",        "filters": [],        "input": {          "entity": "deal"        },        "prev": null,        "next": "create_task"      },      "blocks": {        "create_task": {          "_id": "create_task",          "plugin_id": "clarify:create:record",          "filters": [],          "input": {            "entity": "task",            "attributes": {              "name": "Follow up on new deal"            }          },          "prev": "trigger",          "next": null        }      },      "exits": {},      "run_limits": {},      "_created_at": "2026-01-15T09:30:00.000Z",      "_created_by": "7d4e2f9a-1b3c-4d5e-8f6a-9c0b2d4e6f81",      "_updated_at": "2026-02-01T17:45:00.000Z",      "_updated_by": "7d4e2f9a-1b3c-4d5e-8f6a-9c0b2d4e6f81"    }  }}