> ## Documentation Index
> Fetch the complete documentation index at: https://docs.flowmaticai.in/llms.txt
> Use this file to discover all available pages before exploring further.

# Flowmatic: Automate Email Workflows with a Graph API

> Flowmatic lets you build, run, and monitor data-driven automation pipelines using a simple graph API. Connect CSV data, AI, filters, and email outputs.

Flowmatic is a workflow automation API that lets you define automation pipelines as graphs of connected nodes — upload your data, build your workflow logic, and trigger email campaigns powered by AI or rule-based filters. Everything is accessible through a clean REST API.

<CardGroup cols={2}>
  <Card title="Quick Start" icon="rocket" href="/quickstart">
    Make your first API call and run a workflow in under 5 minutes.
  </Card>

  <Card title="Authentication" icon="lock" href="/authentication">
    Register, verify your email, and get your access token.
  </Card>

  <Card title="Workflow Concepts" icon="diagram-project" href="/concepts/workflows">
    Understand how graphs, nodes, and edges define your automation logic.
  </Card>

  <Card title="API Reference" icon="code" href="/api-reference/auth/register">
    Full reference for every endpoint: auth, uploads, workflows, and runs.
  </Card>
</CardGroup>

## How Flowmatic Works

Flowmatic automation pipelines are defined as **directed graphs**. Each node in the graph performs a specific operation — loading data, filtering rows, running an AI prompt, or sending emails. Nodes pass data to each other along edges.

<Steps>
  <Step title="Create an account">
    Register with your email and password, then verify your email with a one-time OTP code.
  </Step>

  <Step title="Upload your data">
    Upload a CSV file to get an `uploadId`. This becomes your data source inside workflows.
  </Step>

  <Step title="Build a workflow">
    Define a graph with nodes (`TRIGGER`, `DATA_SOURCE`, `AI`, `FILTER`, `OUTPUT`) and edges connecting them. Create it with a single POST request.
  </Step>

  <Step title="Run and monitor">
    Trigger a run. It queues immediately and executes asynchronously. Poll for status as it moves from `PENDING` → `RUNNING` → `SUCCESS`.
  </Step>
</Steps>

## Key Capabilities

<CardGroup cols={3}>
  <Card title="AI Node" icon="brain">
    Use natural language prompts to process and filter your data with an LLM.
  </Card>

  <Card title="Filter Node" icon="filter">
    Apply rule-based expressions (e.g. `rating > 4`) — no AI required.
  </Card>

  <Card title="Output Node" icon="envelope">
    Send templated emails to every row in your filtered dataset.
  </Card>

  <Card title="Async Runs" icon="clock">
    Workflows run asynchronously in a queue. Enqueue multiple runs and monitor them.
  </Card>

  <Card title="CSV Uploads" icon="file-csv">
    Upload any CSV as a reusable data source, referenced by `uploadId`.
  </Card>

  <Card title="Google Drive" icon="google-drive">
    Connect your Google account to source data directly from Drive.
  </Card>
</CardGroup>

<Note>
  All API requests must include a valid Bearer token in the `Authorization` header. See [Authentication](/authentication) to get started.
</Note>