Create Master Workflow

POST /master-workflows

Create a master workflow to group related workflows together. Master workflows enable aggregated conversion tracking and reporting across workflow chains (e.g., prospecting -> qualification -> closing).

Request Body

Field	Type	Required	Description
name	string	Yes	Master workflow name
description	string	No	Master workflow description

Example

curl -X POST https://api.getnexor.ai/api/public/master-workflows \
  -H "Content-Type: application/json" \
  -H "X-API-Key: nxr_live_your_api_key" \
  -d '{
    "name": "Real Estate Pipeline",
    "description": "Groups prospecting and closing workflows"
  }'

Responses

201 — Master workflow created successfully

{
  "success": true,
  "master_workflow": {
    "id": "uuid",
    "name": "Real Estate Pipeline",
    "description": "Groups prospecting and closing workflows",
    "is_active": true,
    "created_at": "2026-02-10T12:00:00Z",
    "updated_at": "2026-02-10T12:00:00Z"
  }
}

400 — Validation error

{
  "error": "Validation error",
  "message": "name is required"
}

401 — Authentication error

See Authentication.

500 — Internal server error