# Fastn

## Fastn

- [Getting Started](https://docs.fastn.ai/fastn/readme.md): Everything you need to go from signup to a working embedded integration — what Fastn is, how it works, and your first end-to-end build.
- [Overview](https://docs.fastn.ai/fastn/readme/getting-started.md): What fastn does, who each part is for, and the path from signup to a live sync.
- [Platform tour](https://docs.fastn.ai/fastn/readme/platform-tour.md): A screen-by-screen walk through the dashboard, so you know where everything lives.
- [Quickstart: your first integration](https://docs.fastn.ai/fastn/readme/quickstart.md): From an empty workspace to a workflow running on a real trigger.
- [Core concepts](https://docs.fastn.ai/fastn/readme/concepts.md): The handful of ideas that everything else in fastn is built from.
- [Tutorials](https://docs.fastn.ai/tutorials/tutorials.md): Step-by-step guided lessons organized by role — SaaS Admin, Developer, and End User.
- [SaaS Admin](https://docs.fastn.ai/tutorials/saas-admin.md): Tutorials for setting up and managing Fastn within your SaaS product organization config, connectors, workflows, widgets, tenants, and access control.
- [Setting up your organization](https://docs.fastn.ai/tutorials/saas-admin/setting-up-your-organization.md): Configure your organization profile, environments, API keys, and project settings after your first Fastn login.
- [Configuring a connector](https://docs.fastn.ai/tutorials/saas-admin/configuring-a-connector.md): Set up a connector with OAuth or API key auth, configure its capabilities, test actions, and manage tenant-level credentials.
- [Creating a workflow via AI](https://docs.fastn.ai/tutorials/saas-admin/creating-a-workflow-via-ai.md): An overview of building a workflow from natural language descriptions.
- [Configuring a workflow in code](https://docs.fastn.ai/tutorials/saas-admin/configuring-a-workflow-in-code.md): Write workflows in the code editor using export default async function(ctx), configure execution tiers, and test with sample input.
- [Setting up triggers](https://docs.fastn.ai/tutorials/saas-admin/setting-up-triggers.md): Create webhook, scheduler, and app event triggers under Integrations → Triggers and route them to your workflows.
- [Building your widget](https://docs.fastn.ai/tutorials/saas-admin/building-your-widget.md): Use the Widget Builder to create an embeddable integration hub add integrations, customize layout and style, and preview the customer experience.
- [Managing customers](https://docs.fastn.ai/tutorials/saas-admin/managing-customers.md): Create customers under Settings → Customers, scope API calls per customer, and monitor customer-level activity.
- [Roles and permissions setup](https://docs.fastn.ai/tutorials/saas-admin/roles-and-permissions-setup.md): Assign system roles (Owner, Admin, Developer, Operator, Viewer, End User), create custom roles, and manage team access.
- [Developer](https://docs.fastn.ai/tutorials/developer.md): Tutorials for building on Fastn's platform from local dev setup, custom connectors, TypeScript workflows, deployment, AI agents, to MCP integration.
- [How embedding works](https://docs.fastn.ai/tutorials/developer/how-embedding-works.md)
- [Embedding quickstart](https://docs.fastn.ai/tutorials/developer/embedding-quickstart.md)
- [Generating embed tokens](https://docs.fastn.ai/tutorials/developer/generating-embed-tokens.md)
- [Authentication and API keys](https://docs.fastn.ai/tutorials/developer/authentication-and-api-keys.md)
- [Finding your org identifier](https://docs.fastn.ai/tutorials/developer/finding-your-org-identifier.md)
- [Understanding tenancy](https://docs.fastn.ai/tutorials/developer/understanding-tenancy.md): An overview of how tenancy works per user and org level in Fastn
- [Deployment](https://docs.fastn.ai/tutorials/developer/deployment.md)
- [MCP gateway integration](https://docs.fastn.ai/tutorials/developer/mcp-gateway-integration.md): Connect AI assistants to Fastn's MCP server i.e. native tools, dynamic tools, per-customer scoping, and integration patterns.
- [Troubleshooting](https://docs.fastn.ai/tutorials/developer/troubleshooting.md)
- [End User](https://docs.fastn.ai/tutorials/end-user.md): Tutorials for end users interacting with Fastn through the embedded widget — connecting apps, customizing integrations, and viewing sync status.
- [Connecting apps via the widget](https://docs.fastn.ai/tutorials/end-user/connecting-apps-via-widget.md): Find available integrations, authorize your accounts, and activate connections through the embedded integration widget.
- [Customizing your integrations](https://docs.fastn.ai/tutorials/end-user/customizing-your-integrations.md): Configure sync preferences, field mappings, scheduling, and other settings for your active integrations through the widget.
- [Extending a pre-built integration](https://docs.fastn.ai/tutorials/end-user/extending-a-prebuilt-integration.md): Change what a pre-built integration does — fields, filters, direction and scope — using the agent inside the widget, and know where its authority ends.
- [Getting alerted](https://docs.fastn.ai/tutorials/end-user/getting-alerted.md): Be told when an integration breaks instead of finding out from a colleague. Set up your own alerts from inside the widget.
- [Connecting Claude and other AI clients](https://docs.fastn.ai/tutorials/end-user/connecting-claude.md): Reaching your integrations from Claude or another MCP client — the share-link route that needs no fastn account, and what to do without one.
- [Viewing sync status and history](https://docs.fastn.ai/tutorials/end-user/viewing-sync-status-and-history.md): Check what's syncing, view execution history, spot errors, and know when to contact support.
- [Build](https://docs.fastn.ai/build/build.md): Everything that defines how an integration behaves.
- [Agent](https://docs.fastn.ai/build/agent.md): The chat-driven builder that picks connectors, drafts workflows and shows you the diff.
- [Approval mode](https://docs.fastn.ai/build/agent/approval-mode.md): How far the agent goes without checking in: Auto versus Manual.
- [Worked example](https://docs.fastn.ai/build/agent/worked-example.md): A real HubSpot-to-Google-Sheets build, from plain-words prompt to bound trigger.
- [Building from your AI agent](https://docs.fastn.ai/build/building-from-your-ai-agent.md): What your own AI agent does after you ask it for an integration, where the result lands in fastn, and how to test it.
- [Connectors](https://docs.fastn.ai/build/connectors.md): What a connector is, how it relates to actions, auth methods, connections and webhooks, and where each part lives in the app.
- [The catalogue](https://docs.fastn.ai/build/connectors/the-catalogue.md): The Connectors page: header buttons, categories, search, filters, connector cards and the guide panel.
- [Creating a connector](https://docs.fastn.ai/build/connectors/creating-a-connector.md): The Create a connector dialog field by field: identity, protocol, visibility and every authentication type, plus Request connector.
- [Inside a connector](https://docs.fastn.ai/build/connectors/inside-a-connector.md): The connector detail page: the connector rail, the header, and the Overview, Connections and Version pins tabs.
- [Auth methods and providers](https://docs.fastn.ai/build/connectors/auth-methods.md): The Auth tab: a connector's authentication methods, the default method, and the OAuth apps (auth providers) behind them.
- [Actions](https://docs.fastn.ai/build/connectors/action-detail.md): A connector's actions: the action list, the action editor and its seven tabs, mocks, versions and proposing an update.
- [Webhook config](https://docs.fastn.ai/build/connectors/webhook-config.md): The Webhook config tab: how fastn subscribes to an app's events for each customer, the config table, and every field of the config form.
- [Editing, publishing and deleting](https://docs.fastn.ai/build/connectors/editing-and-deleting.md): What you can change on a connector your workspace owns: editing it, credential verification, adding actions, publishing versions and deleting it.
- [Importing and exporting](https://docs.fastn.ai/build/connectors/importing-and-exporting.md): Moving connectors and actions in and out of a workspace as JSON files: Import, exporting actions and exporting connectors.
- [Connect a system](https://docs.fastn.ai/build/connectors/connect-a-system.md): Making a connection step by step: open the connect dialog, choose the auth method, give the credential, and check that it worked.
- [Unified APIs](https://docs.fastn.ai/build/unified-apis.md): One canonical endpoint per business entity, served by whichever providers your customers connect.
- [Inside a category](https://docs.fastn.ai/build/unified-apis/inside-a-category.md): Opening a category: entities, connection state, providers and endpoints.
- [Unified vs direct](https://docs.fastn.ai/build/unified-apis/unified-vs-direct.md): When to reach for a unified API and when to call the connector directly.
- [Connections](https://docs.fastn.ai/build/connections.md): The Connections page: your organisation's and your customers' signed-in accounts, how to find one, and what each column means.
- [Statuses](https://docs.fastn.ai/build/connections/statuses.md): What Active, Inactive, Expired and Failed mean, and what to do about each.
- [Auth types](https://docs.fastn.ai/build/connections/auth-types.md): The values in the Auth column and on a connection's detail page, and what each one means for keeping the connection working.
- [Inside a connection](https://docs.fastn.ai/build/connections/inside-a-connection.md): The connection detail page: who and what the connection is, its token and activity, Reconnect, and Disconnect.
- [Creating a connection](https://docs.fastn.ai/build/connections/creating-a-connection.md): Making a connection yourself with New connection: the system picker, key-based methods, OAuth with providers and scopes, and when to use it.
- [Workflows](https://docs.fastn.ai/build/workflows.md): The code that runs on a trigger, a schedule, or an agent call.
- [The editor](https://docs.fastn.ai/build/workflows/the-editor.md): The workflow editor walked through tab by tab, plus the configuration panel reference.
- [The tabs](https://docs.fastn.ai/build/workflows/the-tabs.md): Every tool tab in the editor: Test, Connectors, Contract, Diagram, Test cases, Executions, Sync reports, API and Docs.
- [Lifecycle](https://docs.fastn.ai/build/workflows/lifecycle.md): How a workflow goes from draft to deployed, review gates, and code-off workspaces.
- [Triggers](https://docs.fastn.ai/build/triggers.md): What starts a workflow: an inbound webhook, a schedule, or an event from a connected system.
- [Webhook triggers](https://docs.fastn.ai/build/triggers/webhooks.md): A trigger that fires when another system calls a URL you give it.
- [Schedule triggers](https://docs.fastn.ai/build/triggers/schedulers.md): A trigger that fires on a clock you set.
- [App event triggers](https://docs.fastn.ai/build/triggers/app-events.md): A trigger that fires when something changes in a connected system.
- [Pending updates](https://docs.fastn.ai/build/connector-updates.md): Vendor changes to the integrations you use, and the fixes proposed for them. Nothing is applied until you accept it.
- [MCP gateway](https://docs.fastn.ai/build/mcp-gateway.md): Letting an AI client reach your connectors as tools.
- [Claude](https://docs.fastn.ai/build/mcp-gateway/claude.md): Add fastn to Claude as a custom connector, then build integrations from a Claude chat.
- [ChatGPT](https://docs.fastn.ai/build/mcp-gateway/chatgpt.md): Add fastn to ChatGPT as a custom connector in Developer mode, then build integrations from a chat.
- [Lovable](https://docs.fastn.ai/build/mcp-gateway/lovable.md): Add fastn to Lovable as a chat connector, so the builder chat can use your fastn tools.
- [Bolt](https://docs.fastn.ai/build/mcp-gateway/bolt.md): Add fastn to bolt.new as a custom MCP connector, then build integrations from a chat.
- [Common patterns](https://docs.fastn.ai/build/patterns.md): The handful of workflow shapes that come up again and again.
- [Widgets](https://docs.fastn.ai/embed/embed.md): The integrations panel your customers see inside your own product.
- [Widget builder](https://docs.fastn.ai/embed/widget-builder.md): Integrations, layout, style and features of the panel your customers see.
- [Edit Integration](https://docs.fastn.ai/embed/widget-builder/edit-integration.md): Every field in the Edit Integration dialog: connectors, workflows, callbacks and per-connector overrides.
- [Layout](https://docs.fastn.ai/embed/widget-builder/layout.md): The Layout tab: header content and the sections your customers see.
- [Style](https://docs.fastn.ai/embed/widget-builder/style.md): The Style tab: theme, accent, type, shape and design tokens.
- [Features](https://docs.fastn.ai/embed/widget-builder/features.md): The Features tab: optional capabilities your customers get inside the widget.
- [Embedding the widget](https://docs.fastn.ai/embed/embedding.md): Three ways to put the widget in your product, and how to hand it a token safely.
- [Iframe](https://docs.fastn.ai/embed/embedding/iframe.md): The simplest embed: an HTML iframe tag.
- [SDK](https://docs.fastn.ai/embed/embedding/sdk.md): The SDK mounts the same iframe and adds events, token refresh, theming and modal mode.
- [Token API](https://docs.fastn.ai/embed/embedding/token-api.md): Minting and refreshing embed tokens from your backend, and the session cap.
- [Activity](https://docs.fastn.ai/operate/operate.md): Watching what actually happens once integrations are live.
- [Events](https://docs.fastn.ai/operate/events.md): Everything moving in and out of your customers' systems, newest first.
- [Traces](https://docs.fastn.ai/operate/traces.md): Every workflow run that called a connected system.
- [Alerts](https://docs.fastn.ai/operate/alerts.md): Get told when something crosses a line you care about. Checked every 15 minutes.
- [Executions](https://docs.fastn.ai/operate/executions.md): Every workflow run, newest first.
- [Sync reports](https://docs.fastn.ai/operate/sync-reports.md): What changed on the last run of each sync, record by record.
- [Customers](https://docs.fastn.ai/operate/customers.md): Every customer using your embedded integrations.
- [Troubleshooting](https://docs.fastn.ai/operate/troubleshooting.md): Symptom, where to look, and what usually fixes it.
- [Settings](https://docs.fastn.ai/manage/manage.md): Organisation settings, access, credentials and billing.
- [People](https://docs.fastn.ai/manage/people.md): Who can see and change things in this workspace.
- [Roles](https://docs.fastn.ai/manage/roles.md): What each role can do, and how to narrow one.
- [General](https://docs.fastn.ai/manage/general.md): Your organisation and how people join it.
- [API keys](https://docs.fastn.ai/manage/api-keys.md): Programmatic access to your workspace.
- [Secrets](https://docs.fastn.ai/manage/secrets.md): Encrypted values your workflows read at runtime.
- [Configs](https://docs.fastn.ai/manage/configs.md): Values your workflow code reads per environment.
- [Workflows Tags](https://docs.fastn.ai/manage/workflow-tags.md): Labels and categories: how to create them, attach them to workflows, and what happens when you delete one.
- [Environments and GitHub](https://docs.fastn.ai/manage/environments.md): Deployment stages, and the GitHub review gate in front of them.
- [Database](https://docs.fastn.ai/manage/database.md): Which Postgres your workflows read and write through.
- [SaaS Connectors](https://docs.fastn.ai/manage/saas-connectors.md): Registering your own SaaS API as a connector, and the scopes tenants connect under.
- [Billing and limits](https://docs.fastn.ai/manage/billing.md): Your plan, what you have used, and where the ceilings are.
- [Audit log](https://docs.fastn.ai/manage/audit-log.md): Every action taken in this organisation.
- [Trash](https://docs.fastn.ai/manage/trash.md): Deleted connectors, actions and workflows, kept until you remove them.
- [Your profile](https://docs.fastn.ai/manage/profile.md): Your account and how you sign in. Organisation settings live separately.
- [Workflow runtime API](https://docs.fastn.ai/reference/workflow-runtime.md): What a workflow can reach at runtime: ctx, multi-tenant headers, connectors, unified APIs, database, state, secrets and configs.
- [HTTP API](https://docs.fastn.ai/reference/api.md): Calling workflows and unified endpoints over HTTP.
- [Errors and failure states](https://docs.fastn.ai/reference/errors.md): What each failure state means, where fastn shows you the detail, and what to do about it.
- [fastn for AI agents](https://docs.fastn.ai/reference/ai-agents.md): A single dense page for LLMs and coding agents: the model, the runtime surface, the endpoints, and the things that are easy to get wrong.
- [FAQs](https://docs.fastn.ai/reference/faqs.md): Short answers to the questions that come up most.
- [Glossary](https://docs.fastn.ai/reference/glossary.md): Alphabetized definitions of every term used across the Fastn platform and documentation.
- [Fastn Classic](https://docs.fastn.ai/classic/fastn-classic.md): V1 is in maintenance mode. It will be supported until sunset. New features are only available in V2.
- [Fastn V1: embedded integration platform for AI agents](https://docs.fastn.ai/classic/fastn-classic/fastn-v1-overview.md)
- [Fastn: embedded integration platform for AI agents](https://docs.fastn.ai/classic/fastn-embedded-integration-platform-for-ai-agents.md): Connect AI agents and SaaS applications to 250+ enterprise tools with Fastn's embedded integration platform. Managed OAuth, multi-tenant architecture, and sub-second execution.
- [Embedded Integrations](https://docs.fastn.ai/classic/embedded-integrations.md): These integrations are designed for your customers to use, no need for them to sign in to Fastn directly.
- [Getting Started with Fastn's Embedded Experience](https://docs.fastn.ai/classic/embedded-integrations/getting-started-with-fastns-embedded-experience.md): Learn what the Embedded Experience is, where it's useful, and see how it works through a real-world Shopify example.
- [Building and Configuring Widgets in Fastn](https://docs.fastn.ai/classic/embedded-integrations/getting-started-with-fastns-embedded-experience/building-and-configuring-widgets-in-fastn.md): Learn how to build and configure interactive widgets in Fastn to connect apps, control actions, and deploy them seamlessly for end-users.
- [Previewing and Integrating Widgets](https://docs.fastn.ai/classic/embedded-integrations/getting-started-with-fastns-embedded-experience/previewing-and-integrating-widgets.md): Learn how to preview, authenticate, and embed Fastn widgets into your apps using iframe or React, with options for custom auth, filtering, and connector overrides.
- [Custom Webhooks: Automatic Triggers](https://docs.fastn.ai/classic/embedded-integrations/getting-started-with-fastns-embedded-experience/custom-webhooks-automatic-triggers.md): In Fastn, webhooks enable event-driven automation, so your workflows respond instantly to external changes without the need for constant checking or manual input.
- [Workspace Management](https://docs.fastn.ai/classic/embedded-integrations/workspace-management.md): In the Fastn platform, workspaces are used to organize your created flows, workflows, webhooks, widgets etc.
- [Analytics & Monitoring Dashboard](https://docs.fastn.ai/classic/embedded-integrations/workspace-management/analytics-and-monitoring-dashboard.md): Track Every Integration. Optimize Every Flow.
- [Deployment](https://docs.fastn.ai/classic/embedded-integrations/workspace-management/deployment.md): Manage how your Fastn flows, connectors, and widgets move between environments using releases and pipelines.
- [Releases](https://docs.fastn.ai/classic/embedded-integrations/workspace-management/deployment/releases.md)
- [Pipelines](https://docs.fastn.ai/classic/embedded-integrations/workspace-management/deployment/pipelines.md)
- [Fastn UCL](https://docs.fastn.ai/classic/fastn-ucl.md)
- [Getting Started](https://docs.fastn.ai/classic/fastn-ucl/getting-started.md): Connect your AI agents to 250+ enterprise apps with managed authentication, multi-tenant support, and sub-second execution through Fastn's Unified Context Layer (UCL).
- [About Unified Context Layer](https://docs.fastn.ai/classic/fastn-ucl/getting-started/about-unified-context-layer.md): A unified layer that simplifies integration by handling routing, context, and multitenancy; securely and at scale.
- [Embedding UCL onto your AI Agent](https://docs.fastn.ai/classic/fastn-ucl/getting-started/about-unified-context-layer/embedding-ucl-onto-your-ai-agent.md): This guide will take you through each step, from setting up your environment to seamlessly integrating your tools into your environment.
- [Multitenancy](https://docs.fastn.ai/classic/fastn-ucl/getting-started/about-unified-context-layer/multitenancy.md): This approach provides clear separation and control while optimizing resource usage.
- [Defining an MCP Server](https://docs.fastn.ai/classic/fastn-ucl/getting-started/about-unified-context-layer/defining-an-mcp-server.md): This guide walks you through the process of setting up an MCP server from the UCL dashboard.
- [Creating a Custom Tool](https://docs.fastn.ai/classic/fastn-ucl/getting-started/about-unified-context-layer/creating-a-custom-tool.md): UCL lets you easily build your own custom tool groups using natural language.
- [Monitoring](https://docs.fastn.ai/classic/fastn-ucl/getting-started/about-unified-context-layer/monitoring.md): The Insights page helps you track everything happening across your tenants, connectors, and actions. It is divided into three main parts: Overview, Tool Usage, and Logs.
- [UCL Security & Compliance](https://docs.fastn.ai/classic/fastn-ucl/getting-started/about-unified-context-layer/monitoring/ucl-security-and-compliance.md): This overview highlights UCL’s enterprise-grade security, compliance, and governance capabilities.
- [How UCL Works in Real Scenarios?](https://docs.fastn.ai/classic/fastn-ucl/getting-started/how-ucl-works-in-real-scenarios.md): This section includes a collection of examples and real-world scenarios showing how UCL connects your AI clients with different tools to perform actions, without writing any code.
- [Create a Google Doc and share it to Slack - using UCL](https://docs.fastn.ai/classic/fastn-ucl/getting-started/how-ucl-works-in-real-scenarios/create-a-google-doc-and-share-it-to-slack-using-ucl.md): In this guide, you’ll create a Google Doc with some content and automatically share it to a Slack channel. We’ll use Fastn to connect the two apps and make the workflow run in just a few steps.
- [Connect UCL for task Assignment in Jira](https://docs.fastn.ai/classic/fastn-ucl/getting-started/how-ucl-works-in-real-scenarios/connect-ucl-for-task-assignment-in-jira.md): In this guide, you’ll learn how to use UCL's Playground for AI Assistant to assign Jira tasks with natural language; no integration code needed.
- [Connect UCL to Cursor and access data from Notion](https://docs.fastn.ai/classic/fastn-ucl/getting-started/how-ucl-works-in-real-scenarios/connect-ucl-to-cursor-and-access-data-from-notion.md): In this guide, you’ll learn how to connect a UCL deployment to Cursor and use its AI assistant to retrieve summary from Notion for a specific meeting; all without writing any integration code.
- [Scheduling Flows](https://docs.fastn.ai/classic/scheduling-flows.md): Run flows automatically on a timer whether daily syncs, hourly checks, weekly reports.


---

# 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
This site has an agentic ask interface you may use to query the documentation dynamically by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.fastn.ai/index.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.