> For the complete documentation index, see [llms.txt](https://docs.fastn.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.fastn.ai/~/revisions/m0hEPQFsdMhQVmegKM0n/reference/glossary.md). # Glossary | Term | Definition | | ------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **Action** | An operation a connector can perform on a third-party app. Examples: create a contact, fetch orders, send a message. | | **Action Fixer** | AI sub-agent within the Connector Agent that fixes broken actions using real API docs and applies schema patches. | | **Action Tester** | AI sub-agent within the Connector Agent that executes actions against real test connections and reports pass/fail. | | **Active** | Workflow status indicating it is deployed and can be triggered. Shown as a green checkmark badge in the Workflows table. | | **Admin** | System role with 39 permissions. Full access within organization and customers. | | **Alert Rule** | A monitoring rule under Activity → Alerts that triggers when a metric condition exceeds a threshold. Conditions: error rate, latency p99/p95/avg, throughput, failure count. | | **API Key** | Authentication credential for programmatic access. Two types: Test (development) and Live (production). Managed under Settings → API Keys. Passed via the `x-fastn-api-key` header. | | **App Event** | A trigger type that subscribes to events from connectors (e.g., "Sale Created" from Cin7). Managed under Integrations → Triggers → App Events. | | **Audit Log** | Immutable record of all actions across your organization. Found under Settings → Audit Log. Columns: Timestamp, User, Action, Resource, Outcome. | | **Backfill** | Background process that syncs historical data between systems. | | **Basic Auth** | Authentication method using username/password pair. One of 6 auth methods for connectors. | | **Bearer Token** | Authentication method sending a token in the Authorization header as `Bearer {token}`. One of 6 auth methods for connectors. | | **Build with AI** | Button on the Connectors and Workflows pages that opens the AI agent (Connector Agent or Standalone Workflow Builder) to create resources via natural language. | | **CDM** | Canonical Data Model. Fastn's universal data format. Six entities: Contact, Product, Order, Invoice, InventoryLevel, Fulfillment. | | **CDMContact** | CDM entity for unified customer/contact data. Fields: id, email, firstName, lastName, company, phone, addresses, tags, customFields. | | **CDMFulfillment** | CDM entity for shipping and fulfillment tracking. Fields: id, orderId, status, trackingNumber, carrier, lineItems, shippedAt. | | **CDMInventoryLevel** | CDM entity for real-time inventory. Fields: productId, variantId, locationId, available, onHand, committed, reserved. | | **CDMInvoice** | CDM entity for invoice normalization. Fields: id, contact, lineItems, totals, status, dueDate, payments, currency. | | **CDMOrder** | CDM entity for order data. Fields: id, contact, lineItems, totals, payments, status, shippingAddress, billingAddress. | | **CDMProduct** | CDM entity for product catalog normalization. Fields: id, name, sku, description, variants, pricingTiers, category, status, inventory. | | **Configuration Agent** | AI agent that probes live APIs to gather sample data and helps define filter conditions and targets. | | **Connection** | An authenticated instance of a connector with stored credentials. Each customer creates their own connection. Managed under Integrations → Connections. | | **Connector** | An integration definition for a third-party app. Defines auth methods, actions, and events. Managed under Integrations → Connectors. Created manually (+ Create) or via AI (Build with AI). | | **Connector Agent** | Orchestrated AI agent coordinating 6 sub-agents (Connector Builder, Spec Import Builder, Manual Action Builder, Event Builder, Action Tester, Action Fixer). Accessed via "Build with AI" on Connectors page. | | **Connector Builder** | AI sub-agent within the Connector Agent that creates connectors with auth setup, API actions, and webhook events. | | **Create Connector** | Dialog for manually creating a connector. Fields: Name, Slug, Description, Domain, Visibility, Icon URL, Auth Methods. | | **Custom** | Authentication method using a custom handler for proprietary auth flows. One of 6 auth methods for connectors. | | **Customer** | Your end user. Each customer gets an isolated environment with their own connections, data, and execution history. Managed under Settings → Customers. (Called "Tenant" in V1.) | | **Dead Letter Queue (DLQ)** | PostgreSQL table capturing failed events with full payload and error context. Events can be replayed. | | **Developer** | System role with 34 permissions. Can build connectors, workflows, and agents. Cannot manage billing or org settings. | | **Domain & Access Control** | Setting under Settings → General that controls how users from your email domain join your organization. Supports auto-approve toggle. | | **End User** | System role with 9 permissions. Customer-facing widget access only. | | **Environment** | Deployment environment for workflows (dev, staging, production). Managed under Settings → Environments. | | **Event** | A notification that something happened — incoming webhook, scheduled execution, or manual trigger. Monitored under Activity → Events with filters: All, Webhook, Scheduled, Manual. | | **Event Builder** | AI sub-agent within the Connector Agent that creates webhook events and configures subscribe/unsubscribe lifecycle. | | **Execution** | A single run of a workflow. Logged under Activity → Executions with columns: Time, Workflow, Tier, Version, Status, Duration, Triggered By. | | **Execution Tier** | Workflow configuration that determines execution behavior. Three tiers: Instant (sync, max 60s), Standard (async, default), Long (extended). | | **Execution Timeout** | Maximum time a workflow can run before being terminated. Configurable per workflow. | | **Free Plan** | Default plan for new accounts ($0/mo). Limits: 500 events/day, 10 events/min, 1,000 API calls/day, 20 API calls/min. | | **Hard Block** | Quota enforcement mode. Request rejected immediately with HTTP 429 when limit is reached. | | **HMAC** | Hash-based Message Authentication Code (SHA-256). Used by the webhook receiver to verify incoming webhooks. | | **Instant** | Execution tier. Synchronous — returns result inline. Max 60 seconds. | | **Intelligence Brief** | Multi-agent graph that researches companies and produces integration strategy briefs. | | **Long** | Execution tier. Extended async execution for large data volumes. | | **Manual Action Builder** | AI sub-agent within the Connector Agent that creates API actions one-by-one from docs when no spec exists. | | **MCP** | Model Context Protocol. Open protocol for AI agent tool discovery. Fastn implements an MCP server. | | **No Auth** | Authentication method for public APIs requiring no credentials. One of 6 auth methods for connectors. | | **OAuth 2.0** | Authentication method where users authorize via the app's login screen. Fastn manages token storage and refresh. One of 6 auth methods. | | **OAuth Apps** | Fastn-managed OAuth applications under Settings → OAuth Apps. Authenticate connectors for supported platforms without creating your own OAuth app. | | **Operator** | System role with 18 permissions. Operational access — run workflows, monitor activity. | | **Owner** | System role with 39 permissions. Full access within organization and customers. | | **Planner Agent** | AI sub-agent within the Workflow Agent that analyzes requirements, asks clarifying questions, and produces build plans. | | **Retry Policy** | Workflow setting (toggle on/off) that enables automatic retry on execution failure. | | **RLS** | Row-Level Security. PostgreSQL policies enforcing customer data isolation at the database level. | | **Route** | A mapping within a webhook trigger that directs incoming payloads to a specific workflow. Supports JSON filters and headers. A single webhook can have multiple routes. | | **SaaS Onboarding** | AI agent that guides SaaS companies through the Setup Assistants on the Home page. | | **Scheduler** | A trigger type that runs workflows on a schedule. Presets: Interval, Daily, Weekly, Monthly, Custom. Managed under Integrations → Triggers → Schedulers. | | **Secret** | Encrypted value accessible by workflows at runtime. Managed under Settings → Secrets. | | **Setup Assistants** | AI-guided 5-step onboarding on the Home page: Research → Connectors → Integration → Widget → Done. | | **Slug** | URL-safe identifier for a connector, auto-generated from the name. | | **Spec Import Builder** | AI sub-agent within the Connector Agent that finds and imports machine-readable API specs (OpenAPI, Swagger, Postman). | | **Standard** | Execution tier. Default async execution. | | **Standalone Workflow Builder** | AI workflow builder accessed via "Build with AI" on the Workflows page. Builds and validates only — no planner, config, or connector agents. | | **Tenant Onboarding** | AI agent that helps customers connect tools and configure integrations via the widget. | | **Test Case Agent** | AI sub-agent within the Workflow Agent that generates executable test cases. | | **Trace** | Connector execution trace showing performance data. Monitored under Activity → Traces with filters: All, Success, Error, Pending. | | **Trigger** | What starts a workflow. Three types: Webhook, Scheduler, App Event. Managed separately from workflows under Integrations → Triggers. | | **Viewer** | System role with 7 permissions. Read-only access. | | **Visibility** | Connector setting controlling who can see it. Options: Private, Public. | | **Webhook** | A trigger type that receives events from external services via HTTP POST. Supports routes with JSON filters. Managed under Integrations → Triggers → Webhooks. | | **Workflow** | An automated process written in JavaScript/TypeScript. Each workflow exports a default async function receiving a context object (`ctx`). Managed under Integrations → Workflows. | | **Workflow Agent** | Orchestrated AI agent coordinating Planner Agent, Workflow Builder, and Test Case Agent. | | **Workflow Builder** | AI agent that builds workflows from a plan and validates against test cases. | --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://docs.fastn.ai/~/revisions/m0hEPQFsdMhQVmegKM0n/reference/glossary.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.