Workflows define the identity verification journeys your users complete. In your Workflows, you can combine user-facing modules, background processes, conditions, and results. Refer to Workflows Overview to understand the core concepts behind Workflows.
Workflows are created and configured in Dashboard. In the left menu, click Flow Builder > Workflows. You must have the appropriate role and permissions to create and edit Workflows.
Expand to view image
There are two Workflow builder views: New and Classic. Use the toggles in the top right of your Workflow to set your view. New view introduces a redesigned builder that makes complex workflows easier to create and understand. In New view, you can:
- Follow workflows from left to right on a canvas that arranges itself automatically.
- Identify conditions without opening them.
- Add steps from a searchable catalog.
- Navigate large workflows using zoom and fit-to-screen controls.
- Catch configuration issues before publishing.
Workflows Table
The following table describes the columns in the Workflows table.
| Column | Description |
|---|---|
| Workflow | The name of the Workflow. |
| Date Created | The date the Workflow was created. |
| Last Published | The date the latest version of the Workflow was published. |
| Sessions | The number of identity verification sessions started with the Workflow. |
| Status | Whether the Workflow is active or paused. Active Workflows can start new sessions; paused Workflows cannot. |
| Actions | Displays an icon for testing the Workflow, copying the Workflow's ID and URL, exporting Workflows, pausing and reactivating Workflows, and deleting Workflows. |
Filter the Workflows Table
You can filter the list of Workflows by one or more criteria to find the Workflow you need.
- In Dashboard, click Flow Builder > Workflows in the left menu.
- Click Add Filter in the top left.
- Select a filter: Workflow Name, Created at, Published at, or Number of sessions (more than).
Expand to view image
Expand to learn more about filters
| Filter | Instructions |
|---|---|
| Workflow Name | Enter the Workflow Name. |
| Created at | Click Start Date and use the calendar to select a date. Do the same for End Date. This filter does not allow selecting specific times. |
| Published at | Click Start Date and use the calendar to select a date. Do the same for End Date. This filter does not allow selecting specific times. |
| Number of Sessions (more than) | Enter a number or use the arrows to set the number of Sessions that used a Workflow. |
- Enter or select the filter value.
- Click Apply. The list displays the Workflows that fit the filter criteria.
- Repeat these steps to add additional filters. To remove a filter, click X in its badge.
Create Workflows
Create a Workflow to define the onboarding or authentication experience your users complete. Build the journey from Session Start to a result by adding:
- Modules: Identity verification screens your users interact with, such as capturing a photo of their ID or a selfie.
- Processes: Modules for background processes. Your users don't interact with these. They perform checks, such as document classification and authenticity audits, that help determine the Workflow's result.
- Conditions: Branching decisions that determine the path the Workflow takes. You can use conditions to present different modules to a user and determine the Workflow's result. For example, if the name on a user's driver's license doesn't match the name on their passport, you can use a condition to send them to a module that asks for a third form of ID. If none of the names match, you can specify a fail result.
Before you start building, use this index of modules to determine which modules and processes you want to include in your Workflow.
- In Dashboard, click Flow Builder > Workflows in the left menu.
- Click New in the top right.
- Click Edit
in the top left and enter a new, descriptive name for this Workflow. - Do one of the following, depending on whether you have the New or Classic view enabled in the toggle in the top right:
- New: Add your first module between Session Start and Session Pass. Choose one of the suggested first steps or click Browse all modules to see more options. You can search for a specific module name.
- Classic: In the Modules panel, hover over each module for an overview of what it does and how it appears to the user. Drag modules onto the canvas to build your Workflow. You can also click Select a template on the canvas or Templates in the bottom left corner to start from a template.
Expand to view image of Classic view
- Next to the module you added, click Options
> Edit and configure the module settings. - Click Save configuration.
- Click Add node
to add another module, a process, or a condition. Processes and conditions must come after a module.
Expand to view image of Classic view
- Configure and save the settings of each module, process, and condition.
- Configure the overall Workflow settings.
- To delete a module, process, or condition, click Options
> Delete. - To change a final decision node, click Options
next to it. Select a decision: Pass, Fail, Warn, or Manual Review, then click Update Decision. - If you have New view enabled in the toggle in the top right, click Validate in the top right and resolve any reported issues. Use the arrow next to Validate to switch between validating All at once or Step by step.
- When your Workflow is ready, click Save & Publish.
- Test the workflow and confirm every path behaves as expected.
Choose a Workflow Template
Templates give you a starting point for the most common verification use cases. You can customize the Workflow or individual modules as needed. You can choose from the built-in template options or import your own.
If you have New view enabled in the toggle in the top right, click Templates
at the bottom of the screen to select a built-in template.
Expand to view image of Classic view
The following templates are built in:
- Identity Verification: Includes the modules and processes needed to complete a standard ID-to-Face verification.
- Step Up Age Verification: Uses Face Capture to determine the user's age. If the user's age meets the condition set, ID Capture is not required for authentication. The default age threshold is 25 or older.
- 1:N Authentication Step Up: Allows returning users to authenticate using just their face, compared against anyone's previous authentications. If authentication fails, the user is presented with an opportunity to complete ID verification.
- 1:1 Authentication Step Up: Allows returning users to authenticate using just their face, compared against their own previous authentications. If authentication fails, the user is presented with an opportunity to complete ID verification.
- Self-Service Reset & Recovery: Verifies users’ identities for password resets, MFA resets, and Temporary Access Pass requests. It collects a login identifier, finds the user’s directory, and runs identity verification before routing them through the recovery process. This template is available in New view only.
Import Workflows
Import a Workflow to reuse an exported Workflow configuration instead of rebuilding it manually. The import creates a new Workflow from a JSON configuration file.
- In Dashboard, click Flow Builder > Workflows in the left menu.
- Click Import in the top right.
- Click Import File and select the JSON file you want to upload.
Expand to view image
- Enter a descriptive Workflow Name.
- Click Submit.
- Open the imported Workflow and review its modules, module configurations, processes, conditions, results, and Workflow settings.
- Click Validate in the top right and resolve any reported issues. Use the arrow next to Validate to switch between validating All at once or Step by step.
- When your Workflow is ready, click Save & Publish.
- Test the workflow and confirm every path behaves as expected.
Configure Workflow Settings
Workflow settings control the overall behavior and user experience of a Workflow.
- In Dashboard, click Flow Builder > Workflows in the left menu.
- Select a Workflow.
- Click Settings
in the top right. - Configure the settings in each section. Your changes are saved automatically.
Expand to view the Workflow settings in each section
Deepsight
| Setting | Description |
|---|---|
| Deepsight | Enables Deepsight for this Workflow. This setting is available only when Deepsight is enabled for your organization. It requires separate licensing. |
Session Result
| Setting | Description |
|---|---|
| Automatically create an identity on successful workflow execution | Creates an Incode Identity automatically when the Workflow completes successfully. The identity is then available on the Identities page in Dashboard. |
User Experience
| Setting | Description |
|---|---|
| Skip intro screen | Sends users directly to the verification steps without displaying the launch screen. |
| Show verification result screen | Displays a final screen showing whether the user passed or failed verification. |
| Phishing Resistance | Protects against man-in-the-middle phishing attacks using dynamic QR codes and device-to-session binding. Enabling this setting also enables Redirect desktop attempts to mobile. |
| OAuth2 Secured (web only) | Protects the user journey against replay attacks using OAuth 2.0. A Redirect URL is required when this setting is enabled. |
| Redirect desktop attempts to mobile | Lets users who begin on a desktop transfer the verification to a mobile device. |
| Add continue to desktop | Gives users the option to continue the verification on their desktop instead of transferring it to a mobile device. |
| Redirect origin only | Redirects users only on the device where they started the verification. |
| Enable SMS | Lets users enter a phone number to receive the ID verification link by SMS. |
| Hide unsupported browser screen | Lets users continue without seeing the unsupported-browser screen. Only Chrome and Safari are officially supported. |
| Allowed devices | Restricts the Workflow to selected device types: Mini apps: Lets users complete identity verification in a lightweight app without installing the full mobile application. Web mobile: Lets users complete identity verification in a browser on their mobile device. Web desktop: Lets users complete identity verification in a desktop browser, typically for remote or in-branch verification. |
| Enable SDK 2.0 | Runs the web-based Workflow using Web SDK 2.0 instead of SDK 1.x, providing a modular architecture that loads components as needed for faster performance. |
| Redirect URL | Specifies the URL users are sent to after completing the Workflow. This setting is required when OAuth2 Secured (web only) is enabled. |
| Log session as expired after timeout | Adds an expiration timestamp when a session reaches the configured time limit. Use this setting to monitor user behavior and completion rates around the expiration window. |
Compliance & Privacy
| Setting | Description |
|---|---|
| Age assurance | Displays privacy-adjusted tutorials. Incode stores no personally identifiable information other than the user’s date of birth. |
| Enable mandatory biometric consent | Requires users to provide biometric consent during the Workflow. |
| Store video of ID and face capture in session | Stores video recorded during the ID Capture and Face Capture modules in the session. |
Test Workflows
Test every path through a Workflow to confirm that its modules, conditions, results, and settings behave as expected.
- In Dashboard, click Flow Builder > Workflows in the left menu.
- In the Actions column for the Workflow you want to text, click Test workflow
. - Scan the QR code with your mobile device or click Copy workflow link
and test in your browser.
Additional Options
Expand to view image
Copy Workflow IDs and URLs
Copy the Workflow URL to launch the Workflow or share it with users who need to complete it. Copy the Workflow ID when you need the Workflow’s unique identifier for an integration, an API request, or a support case.
- In Dashboard, click Flow Builder > Workflows in the left menu.
- In the Actions column for the Workflow you want, click Options
. - Select Copy URL or Copy ID.
Export Workflow Configurations
Export a Workflow configuration to download its structure and settings as a JSON file. You can keep the file as a backup or import it to create a new Workflow in another organization or environment.
- In Dashboard, click Flow Builder > Workflows in the left menu.
- In the Actions column for the Workflow you want, click Options
. - Select Export Config.
Pause Workflows
Pause a Workflow to prevent users from starting new identity verification sessions with it. Use this option when you need to make changes or temporarily remove the Workflow from use. You can activate it again when it's ready.
- In Dashboard, click Flow Builder > Workflows in the left menu.
- In the Actions column for the Workflow you want, click Options
. - Select Pause workflow.
Reactivate Workflows
Reactivate a paused Workflow to make it available for new identity verification sessions again. Before reactivating it, confirm that its configuration is current and test each path to ensure it behaves as expected.
- In Dashboard, click Flow Builder > Workflows in the left menu.
- In the Actions column for the Workflow you want, click Options
. - Select Activate workflow.
Delete Workflows
Delete a Workflow when it is no longer needed. Deletion is permanent and cannot be undone, so export the configuration first if you may need to recreate or reference it later.
- In Dashboard, click Flow Builder > Workflows in the left menu.
- In the Actions column for the Workflow you want, click Options
. - Select Delete Workflow.