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

apiKey

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.

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 "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"
    }
  }
}