Add Workflow Leads

{
  "type": "object",
  "properties": {
    "workflow_id": {
      "type": "string",
      "description": "The workflow ID, e.g. workflow_abc123"
    },
    "file_name": {
      "type": "string",
      "description": "File name with extension, e.g. leads.csv or leads.xlsx. Required with file_text/file_base64; taken from the upload otherwise."
    },
    "file_text": {
      "type": "string",
      "description": "Only for rows the user TYPED into the conversation, or a small CSV/text file (under ~50 KB) you were given as a path and can read. Plain text, header row first. Not for a file the user attached in the chat: pass that as `file`."
    },
    "file_base64": {
      "type": "string",
      "description": "Only for a small .xlsx (under ~50 KB) given to you as a path on disk. NEVER base64-encode a file the user attached in the chat (pass it as `file`) and never encode anything larger (use create_upload_url)."
    },
    "upload_id": {
      "type": "string",
      "description": "Only for a file on a disk YOU control that is too large for file_text (over ~50 KB): call create_upload_url with reveal_url: true, PUT the bytes yourself from a machine with open internet access, then pass the upload_id here. Never for a file the user attached in the chat (pass it as `file`), and never from a hosted chat sandbox such as ChatGPT code interpreter, which cannot reach the storage host."
    },
    "file": {
      "type": "object",
      "properties": {
        "file_id": {
          "type": "string",
          "description": "Host-side file id"
        },
        "download_url": {
          "type": "string",
          "description": "Short-lived signed URL the host provides for the attached file"
        },
        "file_name": {
          "type": "string"
        },
        "mime_type": {
          "type": "string"
        },
        "size": {
          "type": "number"
        }
      },
      "required": [
        "file_id",
        "download_url"
      ],
      "additionalProperties": false,
      "description": "ALWAYS use this when the user attached a file in the chat: pass the attached file here and the host turns it into a download link for the server. Fastest path, any size. NEVER open, convert or base64-encode an attached file yourself."
    },
    "tags": {
      "type": "string",
      "description": "Optional tags applied to every lead in this upload, comma-separated, e.g. \"priority,q3-campaign\". Normalised to lowercase."
    }
  },
  "required": [
    "workflow_id"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "workflow_id": {
      "type": "string",
      "description": "The workflow the leads were added to, prefixed workflow_"
    },
    "leads_added": {
      "type": "number",
      "description": "How many leads were created"
    },
    "file_source": {
      "type": "string",
      "description": "How the file arrived: 'text', 'base64', 'upload' (Azure staging) or 'attachment' (host-provided)"
    },
    "lead_ids": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Created lead ids (prefixed lead_), capped at 50"
    },
    "truncated": {
      "type": "boolean",
      "description": "True when more leads were created than lead_ids lists"
    },
    "errors": {
      "type": "array",
      "description": "Rows that failed validation, with the reason"
    },
    "unused_columns": {
      "type": "array",
      "description": "Columns in the file that were not applied, when any"
    },
    "allowed_columns": {
      "type": "array",
      "description": "Columns the workflow accepts, present when unused_columns is"
    },
    "tags": {
      "type": "array",
      "description": "Tags applied to the upload"
    },
    "note": {
      "type": "string",
      "description": "Whether the leads start progressing now or wait for activation"
    }
  },
  "required": [
    "workflow_id",
    "leads_added",
    "file_source",
    "lead_ids",
    "truncated",
    "errors",
    "tags",
    "note"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "add_workflow_leads",
    "arguments": {
      "workflow_id": "workflow_abc123",
      "upload_id": "COMPLETED_UPLOAD_ID"
    }
  }
}