# Flowmatic

## Docs

- [What is Flowmatic? Graph-Based Workflow Automation](https://docs.flowmaticai.in/introduction.md): Flowmatic is a REST API for building graph-based automation pipelines. Define nodes, upload CSV data, and trigger email campaigns powered by AI or filters.
- [Flowmatic Quickstart: Build Your First Workflow in 7 Steps](https://docs.flowmaticai.in/quickstart.md): Follow seven steps to register, verify your email, upload a CSV, build a filter workflow, trigger a run, and check results with the Flowmatic API.
- [Flowmatic Authentication: JWT Tokens and Refresh Guide](https://docs.flowmaticai.in/authentication.md): Register, verify your email, and obtain JWT tokens to authenticate every Flowmatic API request via the Authorization: Bearer header.
- [Workflows: Building Automation Pipelines in Flowmatic](https://docs.flowmaticai.in/concepts/workflows.md): A Flowmatic workflow is a named directed graph of nodes and edges that defines your automation pipeline. Learn how to structure and connect nodes.
- [Node Types: TRIGGER, DATA_SOURCE, AI, FILTER, OUTPUT](https://docs.flowmaticai.in/concepts/nodes.md): Flowmatic workflows are composed of five node types: TRIGGER, DATA_SOURCE, AI, FILTER, and OUTPUT. Each node performs a specific transformation or action.
- [Workflow Runs: Async Execution and Status Lifecycle](https://docs.flowmaticai.in/concepts/runs.md): Flowmatic workflow runs are asynchronous. Runs queue as PENDING and progress to RUNNING, then SUCCESS or FAILED. Learn how to enqueue and monitor runs.
- [How to Upload CSV Data for Use in Flowmatic Workflows](https://docs.flowmaticai.in/guides/upload-data.md): Learn how to upload a CSV file to Flowmatic, get an uploadId, and reference it as a DATA_SOURCE node in your automation workflows.
- [Build an AI-Powered Workflow with Flowmatic Graphs](https://docs.flowmaticai.in/guides/build-ai-workflow.md): Build a Flowmatic workflow that uses an AI node to process CSV data with a natural language prompt and send personalized emails to matching customers.
- [Build a Rule-Based Filter Workflow Without AI in Flowmatic](https://docs.flowmaticai.in/guides/build-filter-workflow.md): Create a Flowmatic workflow that uses the FILTER node to select rows with a rule expression and send emails — no AI or LLM key required.
- [How to Run and Monitor Flowmatic Workflow Executions](https://docs.flowmaticai.in/guides/run-and-monitor.md): Learn how to enqueue a Flowmatic workflow run, poll for live status updates, and inspect per-node execution results after completion.
- [Connect Your Google Drive Account to Flowmatic Workflows](https://docs.flowmaticai.in/guides/google-drive-integration.md): Link your Google account to Flowmatic to use Google Drive as a data source in your workflows. Follow the OAuth connection flow to authorize access.
- [POST /api/auth/register — Create a Flowmatic Account](https://docs.flowmaticai.in/api-reference/auth/register.md): POST /api/auth/register — Create a new Flowmatic account with email, password, and full name. A verification OTP is sent to your email on success.
- [POST /api/auth/verify-email — Verify Your Email OTP](https://docs.flowmaticai.in/api-reference/auth/verify-email.md): POST /api/auth/verify-email — Submit the OTP sent to your email to verify your account. Returns accessToken and refreshToken on success.
- [POST /api/auth/resend-otp — Resend Email Verification OTP](https://docs.flowmaticai.in/api-reference/auth/resend-otp.md): POST /api/auth/resend-otp — Resend a new 6-digit OTP to your email when your previous verification code has expired or did not arrive.
- [POST /api/auth/login — Authenticate a Flowmatic Account](https://docs.flowmaticai.in/api-reference/auth/login.md): POST /api/auth/login — Authenticate with your email and password to receive a JWT access token and refresh token for API requests.
- [POST /api/auth/refresh-token — Refresh Your Access Token](https://docs.flowmaticai.in/api-reference/auth/refresh-token.md): POST /api/auth/refresh-token — Exchange a valid refresh token for a new access token and refresh token pair when your current access token expires.
- [POST /api/uploads — Upload a CSV File to Flowmatic](https://docs.flowmaticai.in/api-reference/uploads/upload-csv.md): POST /api/uploads — Upload a CSV file to Flowmatic and receive an uploadId to reference in DATA_SOURCE nodes within your workflow graphs.
- [POST /api/workflows — Create a Flowmatic Workflow](https://docs.flowmaticai.in/api-reference/workflows/create.md): POST /api/workflows — Define and save a workflow graph with nodes and edges. Supports TRIGGER, DATA_SOURCE, AI, FILTER, and OUTPUT node types.
- [GET /api/workflows — List All Flowmatic Workflows](https://docs.flowmaticai.in/api-reference/workflows/list.md): GET /api/workflows — Retrieve a list of all workflows associated with your account, including their IDs, names, and graph definitions.
- [GET /api/workflows/:workflowId — Retrieve a Workflow](https://docs.flowmaticai.in/api-reference/workflows/get.md): GET /api/workflows/:workflowId — Fetch a single workflow by ID, returning its full graph definition with all nodes, edges, and configuration.
- [DELETE /api/workflows/:workflowId — Delete a Workflow](https://docs.flowmaticai.in/api-reference/workflows/delete.md): DELETE /api/workflows/:workflowId — Permanently delete a workflow by ID, removing its full definition and all associated run history from your account.
- [POST /api/workflows/:workflowId/run — Enqueue a Workflow Run](https://docs.flowmaticai.in/api-reference/runs/enqueue.md): POST /api/workflows/:workflowId/run — Trigger an asynchronous run of a workflow. Returns HTTP 202 immediately with a runId and PENDING status.
- [Retrieve a Workflow Run — GET /api/workflows/runs/:runId](https://docs.flowmaticai.in/api-reference/runs/get.md): GET /api/workflows/runs/:runId — Retrieve the status and per-node output of a workflow run. Poll this endpoint to track progress to SUCCESS or FAILED.
- [GET /api/workflows/:workflowId/runs — List Workflow Runs](https://docs.flowmaticai.in/api-reference/runs/list.md): GET /api/workflows/:workflowId/runs — Retrieve all runs for a specific workflow, showing their status and progression through the execution queue.
- [GET /api/integrations/google/status — Google Status](https://docs.flowmaticai.in/api-reference/integrations/google-status.md): GET /api/integrations/google/status — Check whether your Flowmatic account is connected to Google Drive and retrieve the linked Google account email.
- [Link Google Account — GET /api/integrations/google/connect](https://docs.flowmaticai.in/api-reference/integrations/google-connect.md): GET /api/integrations/google/connect — Initiate the Google OAuth flow to link your Google account with Flowmatic. Opens a 302 redirect to the consent page.