Overview

Stytch provides authentication infrastructure for modern applications, including passwordless login, passkeys/WebAuthn, OAuth, MFA, session management, and related user identity signals. Persona’s integration with Stytch helps teams pull user profile attributes from Stytch into Persona workflows so investigators and operators can make faster, better-informed decisions using trusted authentication context.

With Stytch connected, you can retrieve a specific user (by Stytch User ID or an external ID you’ve set) and search for users in your Stytch project—then use the returned data to enrich downstream workflow steps, internal reviews, or case context.

Benefits

• Faster investigations with authentication context: Pull Stytch user attributes (like verified emails/phone numbers, linked OAuth providers, and passkey/WebAuthn registrations) into Persona to reduce manual lookups and speed up decisioning.
• More reliable user matching: Use a stable identifier (Stytch User ID or external ID) to consistently link Persona workflows back to the correct user record in Stytch.
• Workflow automation for back-office teams: Automatically look up or search for users as part of a Persona workflow, so operations and support teams can standardize review steps without switching tools.

Integration Features

Persona’s Stytch integration supports user lookup and search to power workflow automation and enrichment. Key capabilities include:

• Retrieve user profiles: Fetch a single Stytch user’s identity attributes and authentication signals for use in Persona workflows (for example, verified contact methods, user status, roles, lock state, and metadata).
• Search users across a project: Find users in your Stytch project using optional filters (or return all users) and paginate through results when needed.
• Support test and live environments: Connect Persona to either Stytch Test or Live environments using the corresponding project credentials (each environment has distinct keys and data).

Setting up the Stytch integration

Prerequisites

To set up the Stytch integration, ensure you have:

• Admin access to your Stytch account
• Necessary API permissions to access Stytch credentials

Setting up the Stytch Credentials

1. In the Persona Dashboard, navigate to Integrations > Marketplace and click on Stytch.
2. Click on Add Credential at the top of the page.
3. Enter a nickname for the credential.
4. In your Stytch Dashboard, locate your environment’s Project ID and Secret (Test and Live environments use different credentials).
5. In Persona, enter the Stytch Project ID and Secret for the environment you want to connect.
6. Save the credential, then test it to confirm Persona can connect successfully.

Using the Stytch integration in a workflow

1. Create a new workflow, or open an existing workflow you’d like to update.
2. Add a new action step > Integrations.
3. Select the Stytch integration and choose your saved Stytch credential.
4. Select an operation (for example, retrieving a user or searching users) and map Persona data into the input fields.
5. Save/publish the workflow.

Stytch Operations Overview

In addition to syncing field values, Persona can retrieve user profiles and search for users using Stytch’s API. These actions support seamless two-way workflows, letting teams manage investigations without switching platforms. See below for a comprehensive list of available Workflow Action steps and possible configurations for the Stytch integration:

Retrieve User Workflow Action Step

Retrieve a single Stytch user record so you can reference up-to-date identity and authentication details during a Persona workflow. This is useful when you already have a known identifier (like a user ID from your app, or an external ID you’ve associated with the user) and want to enrich a case or route an investigation based on what Stytch returns.

Configuration Steps:

• Provide values for required fields:
  • User ID (you can supply the Stytch user ID, or an external ID if one is set for the user)

Search Users Workflow Action Step

Search for users within your Stytch project to find matching user records before taking next steps in a workflow (for example, when an investigator only has an email domain, phone number, or partial name). You can run an unfiltered search to return users broadly, or apply filters to narrow results; if results span multiple pages, Stytch provides a cursor-based mechanism to continue retrieving matches.

Configuration Steps:

• Provide values for required fields:
  • None (you can run this action without filters to return users)
• Optionally add:
  • Query (set an operator like AND/OR and include one or more filters—for example, email, phone number, user status, created-at range, or authentication-related signals)
  • Limit (control how many results are returned per page)
  • Cursor (paginate through large result sets using the next cursor returned by Stytch)

FAQs

What Stytch credentials do I need to connect Persona?

You’ll need the Project ID and Secret for the Stytch environment you want Persona to use. Stytch separates Test and Live environments, and each environment has its own credentials and data.

Can I retrieve a Stytch user using an external ID instead of a Stytch user ID?

Yes. When retrieving a user, Stytch allows you to provide an external_id in place of the Stytch user ID—as long as that external ID is set for the user.

How does pagination work when searching users?

If your search returns more results than can fit in one response, Stytch returns a next_cursor. Provide that cursor in a subsequent search request to fetch the next page, and repeat until next_cursor is null.

What kinds of user attributes can Persona retrieve from Stytch?

A retrieved user can include identity and authentication-related attributes such as emails and phone numbers (with verification status), linked OAuth providers, passkey/WebAuthn registrations, TOTP instances, crypto wallets, biometric registrations, roles, lock state, and metadata. Availability depends on what’s present on the user record in your Stytch project.