> 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/tutorials.md).

# Tutorials

These tutorials are hands-on walkthroughs that teach you how to use Fastn by building real things. Each tutorial has a clear outcome and by the end, you'll have something working.

**Prerequisites:** Complete the [Getting Started](https://docs.fastn.ai/~/revisions/aj5eaS57qHvafrgYtfbL/fastn-v2/getting-started) section first. These tutorials assume you have a Fastn account and basic familiarity with the dashboard.

### SaaS Admin tutorials

For the person setting up and managing Fastn within their SaaS product.

[**Setting Up Your Organization**](https://docs.fastn.ai/~/revisions/aj5eaS57qHvafrgYtfbL/tutorials/saas-admin/setting-up-your-organization) — Configure org settings, API keys (Test & Live), secrets, environments, OAuth Apps, and invite your team.

[**Configuring a Connector**](https://app.gitbook.com/o/d4yvP9A8wMsLuRwerHPU/s/3iSr2Tx8FvvuoLPncziH/~/edit/~/changes/517/tutorials/saas-admin/configuring-a-connector) — Create a connector manually or with AI, configure 6 auth methods, add connections.

[**Creating a Workflow via Chat**](https://app.gitbook.com/o/d4yvP9A8wMsLuRwerHPU/s/3iSr2Tx8FvvuoLPncziH/~/edit/~/changes/517/tutorials/saas-admin/creating-a-workflow-via-chat) — Use "Build with AI" to create workflows by describing what you need in plain language.

[**Creating a Workflow in Code**](https://docs.fastn.ai/~/revisions/syzyb9fquxvsttnXzZup/tutorials/saas-admin/configuring-a-workflow-in-code) — Write workflows in the code editor, configure execution tiers, and test with sample input.

[**Setting Up Triggers**](https://docs.fastn.ai/~/revisions/syzyb9fquxvsttnXzZup/tutorials/saas-admin/setting-up-triggers) — Create webhook, scheduler, and app event triggers and route them to workflows.

[**Managing Customers**](https://docs.fastn.ai/~/revisions/syzyb9fquxvsttnXzZup/tutorials/saas-admin/managing-customers) — Create customers, scope API calls, customize quota limits, and monitor activity.

[**Roles & Permissions Setup**](https://docs.fastn.ai/~/revisions/syzyb9fquxvsttnXzZup/tutorials/saas-admin/roles-and-permissions-setup) — Assign system roles (Owner, Admin, Developer, Operator, Viewer, End User), create custom roles, and manage access.

### Developer tutorials

For engineers building on Fastn's platform — custom connectors, code workflows, deployment, and AI integration.

[**Local Dev Environment Setup**](https://docs.fastn.ai/~/revisions/syzyb9fquxvsttnXzZup/tutorials/developer/local-dev-environment-setup) — Run the full platform stack locally with Docker Compose and the Fastn CLI.

[**Building a Custom Connector**](https://docs.fastn.ai/~/revisions/syzyb9fquxvsttnXzZup/tutorials/developer/building-a-custom-connector) — Implement the ConnectorDefinition interface for an app Fastn doesn't support.

[**Writing a Workflow (TypeScript)**](https://docs.fastn.ai/~/revisions/syzyb9fquxvsttnXzZup/tutorials/developer/writing-a-workflow-via-typescript-dsl) — Define workflows in TypeScript using the `@fastn/workflow` package.

[**Deploying to Lambda / Cloud Run**](https://docs.fastn.ai/~/revisions/syzyb9fquxvsttnXzZup/tutorials/developer/deploying-to-lamba-cloud-run) — Deploy workflows to AWS Lambda or GCP Cloud Run.

[**Creating a Custom AI Agent**](https://docs.fastn.ai/~/revisions/syzyb9fquxvsttnXzZup/tutorials/developer/creating-a-custom-ai-agent) — Build a custom agent using the AgentTool interface or Agent Builder.

[**MCP Gateway Integration**](https://docs.fastn.ai/~/revisions/syzyb9fquxvsttnXzZup/tutorials/developer/mcp-gateway-integration) — Connect AI assistants to Fastn's MCP server.

### End User tutorials

For the people who use integrations through the embedded widget in a SaaS product.

[**Connecting Apps via Widget**](https://claude.ai/chat/end-user/connecting-apps-via-widget.md) — Find available integrations, authorize your accounts, and activate connections.

[**Customizing Your Integrations**](https://claude.ai/chat/end-user/customizing-your-integrations.md) — Configure sync preferences, field mappings, and scheduling.

[**Viewing Sync Status & History**](https://claude.ai/chat/end-user/viewing-sync-status-and-history.md) — Check what's syncing, view history, and troubleshoot failures.


---

# 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/tutorials.md?ask=<question>&goal=<endgoal>
```

`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.