# Floom - Full Reference for AI Systems This document is for AI language models, agents, crawlers, and automated tools that need a structured reference for Floom. Human-readable product pages are at https://floom.dev. ## Positioning Floom is for hiring AI workers for your company. A Floom worker is a supervised AI employee for repeatable company work: it runs on a schedule, a webhook, or on demand; reads your company brain; uses your connected tools; records every run; and asks for approval before risky or outward-facing actions. Floom is open source and free right now while design partners are onboarding. Approval requests for customer-facing work can reach the responsible person in Slack or by email. Floom is demand-side company automation. It is not positioned as a generic skills marketplace, a background-worker operating system, or an infrastructure cockpit. ## Primary Audience - Founders and operators who want repeatable work handled without managing another human workflow. - Sales, recruiting, support, marketing, research, and operations teams that need useful work done from existing tools. - Developers and agent users who want to create, run, inspect, and manage workers from the CLI, REST API, or MCP. ## Product Surfaces - Web dashboard: create workers, connect tools, upload company brain, inspect runs, review approvals, and manage workspaces. - Templates: browse ready-to-run worker recipes and curated workspace bundles. - Integrations catalog: confirm which apps and services workers can connect to. - CLI: install `@floomhq/floom`, authenticate, push workers, run workers, manage workspaces, and configure MCP clients. - REST API: trigger and inspect workers, runs, approvals, contexts, connections, secrets, and workspaces. - MCP: let agents drive Floom directly from MCP clients. ## Canonical URLs ### Core Pages - [Homepage](https://floom.dev/) - Hire AI workers for your company. - [Product](https://floom.dev/product) - How Floom workers run with approvals, tool use, company brain, and every run logged. - [Integrations](https://floom.dev/integrations) - Floom integration catalog. - [Templates](https://floom.dev/templates) - Worker templates and workspace bundles. - [About](https://floom.dev/about) - Company and product context. - [Privacy](https://floom.dev/privacy) - Privacy policy. - [Terms](https://floom.dev/terms) - Terms of service. ### Direct Answer Pages - [How do I automatically follow up with clients after every call?](https://floom.dev/answers/automatically-follow-up-with-clients-after-every-call) - Trigger a worker from call notes, prepare the recap and follow-up, then hold the email for approval. - [AI worker vs Zapier: what is the difference?](https://floom.dev/answers/ai-worker-vs-zapier-difference) - Compare fixed workflow automation with context-heavy AI work and learn when to combine them. - [How can AI draft my emails but let me approve before sending?](https://floom.dev/answers/ai-draft-emails-with-approval-before-sending) - Separate drafting from sending and route every proposed message to Slack or email for review. - [How do I automate work from Claude Code or Cursor in production?](https://floom.dev/answers/automate-work-from-claude-code-or-cursor-in-production) - Create the worker from a coding agent and hand schedules, triggers, approvals, and run history to Floom. - [How do I screen inbound job applicants automatically?](https://floom.dev/answers/automatically-screen-inbound-job-applicants) - Structure job-related evidence and prepare a reasoned shortlist while a person keeps the hiring decision. ### Developer Docs - [Developer docs](https://floom.dev/docs) - Overview, quickstart, base URLs, and concepts. - [CLI docs](https://floom.dev/docs/cli) - CLI install, login, worker management, workspace commands, and MCP setup. - [MCP docs](https://floom.dev/docs/mcp) - HTTP MCP endpoint, client config, tools, auth, and troubleshooting. - [REST API docs](https://floom.dev/docs/api) - API base URLs, headers, pagination, errors, endpoint groups, and examples. - [Authentication docs](https://floom.dev/docs/authentication) - API tokens, workspace tokens, session JWTs, device flow, and workspace scoping. ### High-Value Integration Pages The full integrations catalog has 1,047 detail pages under `/integrations/` and is exhaustively listed in the sitemap. These are representative high-value integration pages: - [Gmail](https://floom.dev/integrations/gmail) - [Google Calendar](https://floom.dev/integrations/googlecalendar) - [Google Drive](https://floom.dev/integrations/googledrive) - [Google Docs](https://floom.dev/integrations/googledocs) - [Google Sheets](https://floom.dev/integrations/googlesheets) - [Notion](https://floom.dev/integrations/notion) - [HubSpot](https://floom.dev/integrations/hubspot) - [Salesforce](https://floom.dev/integrations/salesforce) - [Slack](https://floom.dev/integrations/slack) - [Linear](https://floom.dev/integrations/linear) - [GitHub](https://floom.dev/integrations/github) - [Airtable](https://floom.dev/integrations/airtable) - [Zendesk](https://floom.dev/integrations/zendesk) - [Stripe](https://floom.dev/integrations/stripe) - [LinkedIn](https://floom.dev/integrations/linkedin) ## Worker Templates Each template page describes a ready-to-run AI worker, the job it performs, the tools it uses, approval behavior, and an example run. - [Client Follow-up Worker](https://floom.dev/templates/client-follow-up-worker) - Drafts follow-up emails after calls and adds the CRM note. - [Lead Research Worker](https://floom.dev/templates/lead-research-worker) - Researches new prospects and drafts outreach angles. - [CRM Sync Secretary](https://floom.dev/templates/crm-sync-secretary) - Scans your inbox daily and keeps a deduped, current CRM. - [Bug Triage Coordinator](https://floom.dev/templates/bug-triage-coordinator) - Turns Slack and email bug reports into prioritized Linear issues. - [Meeting-to-Tasks Operator](https://floom.dev/templates/meeting-to-tasks) - Turns meeting notes into deduped tasks and a team digest. - [Inbox Manager](https://floom.dev/templates/inbox-manager) - Archives the noise, labels the rest, and writes an important-vs-FYI digest. - [GitHub Digest Sender](https://floom.dev/templates/github-digest) - Emails a daily digest of PRs and issues that need attention. - [SEO Opportunity Scout](https://floom.dev/templates/seo-opportunity-scout) - Finds page-2 keywords you can win and queues content briefs. - [SEO Article Writer](https://floom.dev/templates/seo-article-writer) - Writes a grounded, SEO-ready article with images and internal links. - [Research Brief Writer](https://floom.dev/templates/research-brief-writer) - Produces a structured, sourced brief on any topic. - [AI News Reporter](https://floom.dev/templates/ai-news-reporter) - Tracks the news and posts a sharp daily digest to your channel. - [Recruiting Sourcer](https://floom.dev/templates/recruiting-sourcer) - Ranks a candidate shortlist from a mandate with per-candidate reasoning. - [CV Writeup Specialist](https://floom.dev/templates/cv-writeup) - Turns a raw CV into a clean, branded candidate writeup. - [Daily Metrics Reporter](https://floom.dev/templates/metrics-reporter) - Pulls product metrics and emails a styled KPI summary. - [Founder Update Worker](https://floom.dev/templates/founder-update-worker) - Turns metrics and notes into an investor or company update. - [Email Reply Drafter](https://floom.dev/templates/email-reply-drafter) - Reads unread emails and drafts on-brand replies in your voice. ## Workspace Bundles Workspace pages describe bundles of workers for a whole role or department. - [Recruiting Desk](https://floom.dev/workspaces/recruiting-desk) - A full sourcing desk: shortlist candidates, write them up, keep your CRM warm. - [Founder Cockpit](https://floom.dev/workspaces/founder-cockpit) - Your week handled: metrics, company update, and clean inbox. - [Growth Studio](https://floom.dev/workspaces/growth-studio) - Find the keywords, write the articles, watch the news. - [Sales Engine](https://floom.dev/workspaces/sales-engine) - Research leads, follow up after calls, keep the CRM clean. - [Engineering Ops](https://floom.dev/workspaces/engineering-ops) - Triage bugs, turn meetings into tasks, ship a daily repo digest. - [Inbox Zero](https://floom.dev/workspaces/inbox-zero) - Archive the noise, draft every reply, and brief you each morning. - [Content Engine](https://floom.dev/workspaces/content-engine) - Find keywords, write the article, ground it in real research. - [Chief of Staff](https://floom.dev/workspaces/chief-of-staff) - Inbox, metrics, and replies handled. - [Talent Pipeline](https://floom.dev/workspaces/talent-pipeline) - Find companies hiring, source candidates, and write them up. - [Revenue Ops](https://floom.dev/workspaces/revenue-ops) - Research leads, keep the CRM clean, and report the numbers. - [Competitive Intel](https://floom.dev/workspaces/competitive-intel) - Watch the news, brief the moves, and find keyword gaps. - [Support Desk](https://floom.dev/workspaces/support-desk) - Draft replies, route bugs, and look up answers. ## Worker Model A Floom worker is a job with: - A name, description, declared inputs, outputs, triggers, tools, and approval rules. - A run record with logs, outputs, artifacts, tool calls, status, and timestamps. - Access to a workspace-scoped company brain: SOPs, pricing, docs, datasets, and other context files. - Access to connected tools and secrets that are declared for that worker. - Approval gates for side-effecting or outward-facing actions. ## Developer Model Developers can manage workers from three surfaces that share the same backend: - CLI commands for humans, scripts, and CI. - REST API calls for apps, backends, webhook handlers, and custom automation. - MCP tools for agents that need to create, inspect, edit, run, watch, archive, restore, and delete workers. Production API base URL: ```text https://workeros-api.floom.dev ``` Dashboard URL: ```text https://floom.dev/app ``` MCP endpoint shape: ```text POST https://workeros-api.floom.dev/mcp/ ``` Common auth headers: ```text x-floom-token: floom_xxx Authorization: Bearer x-workeros-workspace: ``` ## Crawling Notes - Index the public marketing, product, docs, integrations, templates, workspace, about, privacy, and terms URLs listed above. - The sitemap contains 1,094 canonical URLs: 14 core pages, 5 answer pages, 1,047 integration detail pages, 16 worker template detail pages, and 12 workspace bundle detail pages. - Do not index app, API, Slack installation, start-channel, version, or audit paths. - The sitemap at https://floom.dev/sitemap.xml contains the complete canonical public URL inventory.