Stytch · Controlled Vocabulary

Stytch Vocabulary

Vocabulary of key terms, concepts, and objects used across the Stytch authentication platform. Covers passwordless authentication, session management, B2B multi-tenancy, and identity infrastructure.

25 Terms Updated 2026-05-22
View Vocabulary File View on GitHub

Stytch Vocabulary is a controlled vocabulary published by Stytch on the APIs.io network, defining 25 terms.

Defined terms include Magic Link, OTP (One-Time Passcode), Session Token, Session JWT, and User.

A controlled vocabulary pins the words an API’s schemas, parameters and documentation use to one agreed definition each — the shared language a human or an agent needs to read the API the same way its authors do.

Terms

Magic Link
An email containing a one-click authentication link that logs in or signs up a user without requiring a password. The link contains a time-limited token and redirects to the application after clicking. Expires after a configurable duration.
OTP (One-Time Passcode)
A short numeric code (typically 6 digits) sent to a user via SMS, email, or WhatsApp. Valid for a single use within a short time window. Stytch supports SMS OTP, email OTP, and WhatsApp OTP.
Session Token
An opaque string returned after successful authentication. Used in server-side requests to identify the authenticated user. Pairs with a Session JWT for client-side use.
Session JWT
A JSON Web Token (JWT) representing the user's session. Contains claims about the user, organization (B2B), and authentication factors. Can be validated locally without a network call to Stytch.
User
A Stytch Consumer user record identified by user_id (prefix: user-). Stores email addresses, phone numbers, name, and metadata. Created automatically on first login.
Member
A Stytch B2B user within an Organization. Identified by member_id (prefix: member-). Has roles, a status (active, invited, deleted), and belongs to exactly one organization.
Organization
A B2B tenant in Stytch. Represents a customer company or workspace. Contains members, SSO configurations, and access policies. Identified by organization_id (prefix: organization-).
SSO (Single Sign-On)
Authentication through an enterprise identity provider (IdP). Stytch B2B supports SAML 2.0 and OIDC protocols. Connections are configured per organization and can be used for just-in-time (JIT) member provisioning.
TOTP (Time-Based One-Time Password)
An authenticator app-based second factor. Users register a TOTP device (Google Authenticator, Authy, etc.) and use 6-digit rotating codes to authenticate. Stytch Consumer only.
WebAuthn
Browser-native biometric and hardware key authentication (passkeys, fingerprint, Face ID, hardware security keys). Stytch implements the W3C WebAuthn standard for phishing-resistant authentication.
OAuth
Social login via OAuth 2.0 providers (Google, Apple, Microsoft, GitHub, etc.). Users click a provider button and authorize access. Stytch handles the OAuth flow and creates or links a user record.
Project ID
The public identifier for a Stytch project. Used as the username in HTTP Basic authentication. Format: project-live-xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx (live) or project-test-xxx (test).
Secret
The private API key for a Stytch project. Used as the password in HTTP Basic authentication. Never expose in client-side code. Must be rotated if compromised.
JIT Provisioning
Just-In-Time automatic member creation when a user authenticates via SSO for the first time. Configurable per organization. Avoids manual invitation workflows.
Intermediate Session Token
A short-lived token issued during the B2B organization discovery flow when a user has authenticated but hasn't yet selected which organization to log into.
Authentication Factor
A record of how a user authenticated in the current session. Stored in the session object. Includes the method (magic_link, otp, sso), the factor type, and timestamp. Multi-factor sessions include multiple factors.
Connected App
An OAuth 2.0 / OIDC client registered under a Stytch project so an external tool — a third-party integration, desktop app, AI agent, or MCP server — can request scoped, user-consented access to the product Stytch protects. Connected Apps make the Stytch-secured product itself act as an Authorization Server.
MCP Server Client
A specific kind of Connected App — a Model Context Protocol server registered as a public OAuth client (with PKCE) so AI agents can obtain scoped tokens to call your tools.
M2M Client
A machine-to-machine OAuth 2.0 client. Holds a client_id + client_secret pair and a set of scopes; exchanges them for short-lived JWT access tokens via the client_credentials grant. Used for service-to-service auth and headless automation.
Discovery Flow
The B2B authentication path where a user first authenticates (via Magic Link, OAuth, or SSO) and is then offered the list of organizations they may join. Concludes by exchanging an intermediate session token for an org-scoped session.
SCIM Connection
A per-organization SCIM 2.0 endpoint Stytch exposes so an enterprise customer's IdP can push directory updates — create / update / disable members and groups. Complements SAML / OIDC SSO with automated provisioning and deprovisioning.
Device Fingerprint
A telemetry signal collected by Stytch's DFP browser / mobile SDK. The server-side fingerprint lookup turns a telemetry_id into a verdict (allow / challenge / block) plus a visitor_id and verdict reasons used for adaptive MFA.
Verdict Action
The Stytch fraud system's recommended action for a request — typically allow, challenge, or block. Drives adaptive MFA / step-up logic and Connected Apps consent decisions.
Impersonation
A controlled flow that lets staff act as a User or Member to debug or support a customer account. Impersonation sessions are tagged distinctly so they can be audited and revoked separately from normal sessions.
Management API
Stytch's programmatic configuration surface (host management.stytch.com) for projects, environments, secrets, RBAC policies, JWT templates, email templates, event log streaming, public tokens, and trusted token profiles. Separate from the runtime auth API at api.stytch.com.

Controlled Vocabulary

Raw ↑
name: Stytch
description: >-
  Vocabulary of key terms, concepts, and objects used across the Stytch authentication platform.
  Covers passwordless authentication, session management, B2B multi-tenancy, and identity infrastructure.
version: "1.1"
created: "2026-05-02"
modified: "2026-05-22"
tags:
  - Authentication
  - Identity
  - Passwordless
  - B2B

terms:
  - term: Magic Link
    definition: >-
      An email containing a one-click authentication link that logs in or signs up a user
      without requiring a password. The link contains a time-limited token and redirects
      to the application after clicking. Expires after a configurable duration.
    category: Authentication Method
    tags:
      - Passwordless
      - Email

  - term: OTP (One-Time Passcode)
    definition: >-
      A short numeric code (typically 6 digits) sent to a user via SMS, email, or WhatsApp.
      Valid for a single use within a short time window. Stytch supports SMS OTP, email OTP,
      and WhatsApp OTP.
    category: Authentication Method
    tags:
      - Passwordless
      - OTP

  - term: Session Token
    definition: >-
      An opaque string returned after successful authentication. Used in server-side requests
      to identify the authenticated user. Pairs with a Session JWT for client-side use.
    category: Session Management
    tags:
      - Sessions
      - Security

  - term: Session JWT
    definition: >-
      A JSON Web Token (JWT) representing the user's session. Contains claims about the user,
      organization (B2B), and authentication factors. Can be validated locally without a
      network call to Stytch.
    category: Session Management
    tags:
      - Sessions
      - JWT

  - term: User
    definition: >-
      A Stytch Consumer user record identified by user_id (prefix: user-). Stores email addresses,
      phone numbers, name, and metadata. Created automatically on first login.
    category: Core Object
    tags:
      - Consumer
      - Identity

  - term: Member
    definition: >-
      A Stytch B2B user within an Organization. Identified by member_id (prefix: member-).
      Has roles, a status (active, invited, deleted), and belongs to exactly one organization.
    category: Core Object (B2B)
    tags:
      - B2B
      - Identity

  - term: Organization
    definition: >-
      A B2B tenant in Stytch. Represents a customer company or workspace. Contains members,
      SSO configurations, and access policies. Identified by organization_id (prefix: organization-).
    category: Core Object (B2B)
    tags:
      - B2B
      - Multi-Tenant

  - term: SSO (Single Sign-On)
    definition: >-
      Authentication through an enterprise identity provider (IdP). Stytch B2B supports SAML 2.0
      and OIDC protocols. Connections are configured per organization and can be used for
      just-in-time (JIT) member provisioning.
    category: Authentication Method
    tags:
      - SSO
      - SAML
      - OIDC
      - B2B

  - term: TOTP (Time-Based One-Time Password)
    definition: >-
      An authenticator app-based second factor. Users register a TOTP device (Google Authenticator,
      Authy, etc.) and use 6-digit rotating codes to authenticate. Stytch Consumer only.
    category: Authentication Method
    tags:
      - TOTP
      - MFA

  - term: WebAuthn
    definition: >-
      Browser-native biometric and hardware key authentication (passkeys, fingerprint, Face ID,
      hardware security keys). Stytch implements the W3C WebAuthn standard for phishing-resistant authentication.
    category: Authentication Method
    tags:
      - WebAuthn
      - Biometrics
      - Passkeys

  - term: OAuth
    definition: >-
      Social login via OAuth 2.0 providers (Google, Apple, Microsoft, GitHub, etc.). Users
      click a provider button and authorize access. Stytch handles the OAuth flow and
      creates or links a user record.
    category: Authentication Method
    tags:
      - OAuth
      - Social Login

  - term: Project ID
    definition: >-
      The public identifier for a Stytch project. Used as the username in HTTP Basic authentication.
      Format: project-live-xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx (live) or project-test-xxx (test).
    category: API Concept
    tags:
      - API Keys
      - Authentication

  - term: Secret
    definition: >-
      The private API key for a Stytch project. Used as the password in HTTP Basic authentication.
      Never expose in client-side code. Must be rotated if compromised.
    category: API Concept
    tags:
      - API Keys
      - Security

  - term: JIT Provisioning
    definition: >-
      Just-In-Time automatic member creation when a user authenticates via SSO for the first
      time. Configurable per organization. Avoids manual invitation workflows.
    category: B2B Feature
    tags:
      - SSO
      - Provisioning
      - B2B

  - term: Intermediate Session Token
    definition: >-
      A short-lived token issued during the B2B organization discovery flow when a user
      has authenticated but hasn't yet selected which organization to log into.
    category: B2B Feature
    tags:
      - B2B
      - Discovery
      - Sessions

  - term: Authentication Factor
    definition: >-
      A record of how a user authenticated in the current session. Stored in the session
      object. Includes the method (magic_link, otp, sso), the factor type, and timestamp.
      Multi-factor sessions include multiple factors.
    category: Session Concept
    tags:
      - MFA
      - Sessions

  - term: Connected App
    definition: >-
      An OAuth 2.0 / OIDC client registered under a Stytch project so an external tool — a
      third-party integration, desktop app, AI agent, or MCP server — can request scoped,
      user-consented access to the product Stytch protects. Connected Apps make the Stytch-secured
      product itself act as an Authorization Server.
    category: Authorization
    tags:
      - Connected Apps
      - OAuth
      - OIDC
      - MCP
      - AI Agents

  - term: MCP Server Client
    definition: >-
      A specific kind of Connected App — a Model Context Protocol server registered as a public
      OAuth client (with PKCE) so AI agents can obtain scoped tokens to call your tools.
    category: Authorization
    tags:
      - MCP
      - AI Agents
      - Connected Apps

  - term: M2M Client
    definition: >-
      A machine-to-machine OAuth 2.0 client. Holds a client_id + client_secret pair and a set
      of scopes; exchanges them for short-lived JWT access tokens via the client_credentials
      grant. Used for service-to-service auth and headless automation.
    category: Authorization
    tags:
      - M2M
      - OAuth
      - Client Credentials

  - term: Discovery Flow
    definition: >-
      The B2B authentication path where a user first authenticates (via Magic Link, OAuth, or
      SSO) and is then offered the list of organizations they may join. Concludes by exchanging
      an intermediate session token for an org-scoped session.
    category: B2B Feature
    tags:
      - B2B
      - Discovery
      - Multi-Tenant

  - term: SCIM Connection
    definition: >-
      A per-organization SCIM 2.0 endpoint Stytch exposes so an enterprise customer's IdP can
      push directory updates — create / update / disable members and groups. Complements SAML
      / OIDC SSO with automated provisioning and deprovisioning.
    category: B2B Feature
    tags:
      - SCIM
      - Provisioning
      - B2B

  - term: Device Fingerprint
    definition: >-
      A telemetry signal collected by Stytch's DFP browser / mobile SDK. The server-side
      fingerprint lookup turns a telemetry_id into a verdict (allow / challenge / block) plus
      a visitor_id and verdict reasons used for adaptive MFA.
    category: Fraud & Risk
    tags:
      - Fraud
      - Device Fingerprinting
      - Bot Detection

  - term: Verdict Action
    definition: >-
      The Stytch fraud system's recommended action for a request — typically allow, challenge,
      or block. Drives adaptive MFA / step-up logic and Connected Apps consent decisions.
    category: Fraud & Risk
    tags:
      - Fraud
      - Adaptive MFA

  - term: Impersonation
    definition: >-
      A controlled flow that lets staff act as a User or Member to debug or support a customer
      account. Impersonation sessions are tagged distinctly so they can be audited and revoked
      separately from normal sessions.
    category: Operations
    tags:
      - Support
      - Auditing

  - term: Management API
    definition: >-
      Stytch's programmatic configuration surface (host management.stytch.com) for projects,
      environments, secrets, RBAC policies, JWT templates, email templates, event log
      streaming, public tokens, and trusted token profiles. Separate from the runtime auth
      API at api.stytch.com.
    category: API Concept
    tags:
      - Management
      - Configuration

Work with this as data

Every vocabulary here is available over the APIs.io API and to AI agents over MCP. Vocabularies is not yet its own endpoint on the v1 API. Reach it through catalog search and the tag graph, or the MCP server.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for vocabularies

3 MCP tools reach this
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
Search the catalog
curl "https://apis.io/api/v1/search?q=stytch-vocabulary&limit=10"
Everything under a tag
curl "https://apis.io/api/v1/tags/stytch-vocabulary"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. By signing up you are subscribing to the APIs.io and API Evangelist newsletters — you can unsubscribe from any issue. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.