Skip to main content
The first step to using fal is setting up your account. When you sign up, you get a personal account that comes with its own API keys, deployed apps, and billing. If you’re working with others, you can create a team so everyone shares a single set of API keys, deployments, and billing instead of managing their own. This is useful whether you are consuming Model APIs together or deploying your own models with Serverless. Your identity on fal is separate from the accounts you operate under. You log in as yourself, then choose which account context to work in, whether that’s your personal account or a team you belong to. This means one person can switch between multiple accounts without logging out.

​
Account Types

Account typeWhat it is
PersonalCreated when you sign up. Your individual account.
TeamA shared workspace with its own API keys, apps, and billing. Members are invited and assigned roles.
OrganizationAn enterprise parent that manages multiple teams with centralized policies and SSO.
Teams can exist on their own (standalone) or as children of an organization. Standalone teams work well for small groups. Organizations add centralized policies, SSO, and cross-team visibility. Each team maintains its own API keys, secrets, deployed apps, and billing, completely separate from your personal account.

​
Sign In

fal supports GitHub OAuth, Google OAuth, and SSO/SAML. If your company has SSO configured, you’ll use that automatically. Otherwise, sign in with GitHub or Google. All methods are browser-based and take you straight to the dashboard.
Each login method creates a separate account. If you sign in with Google and later sign in with SSO using the same email, you will have two separate personal accounts with separate API keys, credits, and deployed apps. Social logins (Google + GitHub) with the same email are merged into one account, but SSO and social logins are always kept separate. If you have SSO enabled for your organization, use SSO consistently to avoid duplicate accounts.

​
Get Your API Key

All requests to fal require authentication. Create an API key in the dashboard, then set it as an environment variable: 
export FAL_KEY="your-api-key-here"
When creating a key, you’ll choose a scope:
ScopeUse case
APICalling any model on fal, including Model APIs and your own deployed endpoints.
ADMINEverything in API, plus CLI operations (fal deploy, fal run), managing apps, and accessing admin-scoped Platform APIs. Use this for Serverless deployments.
API keys belong to accounts, not people. A team’s API key is shared by all team members and accesses that team’s resources. When creating a key, make sure the correct account is selected in the top-left corner of the dashboard.

​
Switching Between Accounts

All operations, including API calls, deployments, and billing, happen under whichever account is active. You can switch accounts in two ways depending on how you interact with fal. In the dashboard, select the account in the top-left corner. This controls which account’s resources you see and which account new API keys are scoped to. If you’re using the fal CLI, you have two options. The recommended approach is fal auth login, which opens a browser-based login flow and lets you select your team account interactively. Alternatively, use fal teams set to switch the active account for all subsequent commands, or pass --team on any command. 
# Browser-based login (recommended for SSO users)
fal auth login

# Switch your CLI context to a team
fal teams set my-company

# Or target a team for a single command
fal deploy my_app.py::MyApp --team my-company
You can also use fal profile to manage multiple named profiles, each with its own API key and host. This is useful if you work across multiple accounts or environments and want to switch between them without re-authenticating. 
fal profile create staging
fal profile key  # set API key for this profile
fal profile set staging  # switch to this profile
fal profile unset  # go back to default

​
Next Steps

Teams

Create shared workspaces with roles, API keys, and request attribution

Organizations

Enterprise policies, SSO, and multi-team management

Data Retention & Storage

How generated media is stored and how to control file expiration

Resources

Client libraries, API references, and community links