Skip to content
For the complete documentation index, see llms.txt. This page is also available as Markdown.

Workflows

Build KYC and KYB onboarding workflows with integrated AML screening. Combine identity verification, customer questionnaires, compliance policies, and follow-up actions in one verification journey.

Workflows Overview

ComplyCube Workflows let you design and manage customer verification journeys in the Portal. Choose the checks and information you need, configure how results are evaluated, and decide what happens when a session is Clear, needs Attention, or is Rejected.

A workflow can combine Document Check, biometric liveness verification, AML Screening, and other services. Add Smart Forms to collect customer information and declarations, eSignatures to capture signed agreements, and Compliance Policies to evaluate defined requirements.

The workflow defines the journey. A workflow session records one customer's progress, evidence, results, and activity as they complete it.

Part of the journey
What you configure

Entry controls

Access restrictions, contact verification, document autofill, and consent.

Verification

Checks, questionnaires, and customer-facing capture settings.

Outcome and actions

Session decision rules, client stage updates, and review cases.

Ongoing follow-up

Lifecycle triggers associated with the workflow, such as periodic reviews.

Use Workflows when you need a complete verification journey with multiple steps, session tracking, and decision rules. Direct Checks let you run individual checks without the workflow layer. Workflows are recommended for most regulated onboarding use cases.

Learn more about Workflows and Direct Checks.

If you're on a legacy plan, you may need to contact your Account Manager or support to enable Workflows.

Interactive guide

Benefits

Workflows simplify KYC and KYB onboarding, combining verification, compliance decisions, and follow-up in one journey.

  • Faster setup: Launch with ready-made templates tailored to your use case.

  • Low and no-code integration: Integrate through the Hosted Solution, SDKs, or API, then manage workflow changes centrally.

  • Flexible onboarding journeys: Combine verification checks with dynamic questionnaires and electronic signing.

  • Policy-driven compliance: Apply regulatory and custom policies to support consistent KYC and AML decisions (e.g., UK DIATF Right to Work, Singapore MAS, Germany BaFin, FATF).

  • Automated follow-up: Configure outcome rules, update client stages, and open review cases.

  • Adaptable verification: Add checks or update policies without rebuilding your integration.

  • Data protection by design: Collect relevant information to support data minimization.

  • Oversight and auditability: Track customer journeys, decisions, and workflows from one place.

Creating workflows

Open workflows page in the Portal and create a new workflow. The template picker lets you start with predefined steps and, where included, compliance policies.

Workflows - The template selection wizard.

Recommended templates appear first, based on your industry and country. Templates are grouped by region, with your country's region expanded first. Filter by check, policy, or country to narrow the list. When you apply several filters, a template must match all of them.

Select a template to review its steps and policies, then choose Use this template. You can also create a blank workflow or import an exported configuration.

A template is a starting configuration. Review its steps, policies, and settings against your requirements before activating it.

Designing workflows

The workflow designer displays your journey from top to bottom. The Library on the left contains the checks and forms you can add. The canvas shows the journey, and the settings panel on the right displays the selected item's configuration.

Workflows - Preview of the workflow designer.

The top bar shows the workflow's name, version, and status. Use Flow / Lifecycle to switch views, Undo / Redo to reverse or restore changes, and Preview to open the customer-facing web journey. More (…) contains advanced settings and import and export options.

Adding and arranging steps

  1. Find a check or Smart Form in the Library. You can search by name or browse the categories.

  2. Drag the item onto the canvas.

  3. Select the step to configure it in the settings panel.

  4. Drag steps to change their order, or use Move up / Move down from a step's "…" menu.

  5. To remove a step, drag it back to the Library or select Remove. Use Undo to restore it if needed.

Workflows - Add verification steps where they belong in the customer journey.

The Library shows services outside your plan, but they cannot be added. Some check types have placement or quantity restrictions.

Configuring steps

A step can have up to three settings tabs:

Tab
What it controls

Basic

The step name, its ID, and a link to the service's documentation. For a Smart Form, open the form designer here.

Capture

The customer-facing experience, such as accepted document types, capture attempts, live capture, NFC, or available countries.

Processing

How results are evaluated, including supported thresholds, minimum age, monitoring, and data validation settings.

ComplyCube automatically assembles the customer-facing capture screens needed for the selected checks, showing only relevant screens and minimizing data collection through privacy by design.

Configure each check's capture and processing settings within the workflow to control the journey and its evaluation.

Workflow details

Select an empty area of the canvas to open the workflow's details panel. Here you can review its name, ID, description, last update, and associated lifecycle triggers.

The panel also contains Compliance Policies, including their revisions and an option to update to a newer revision.

Entry controls

Configure entry controls to determine who can begin a session and what happens before verification.

Access restrictions

This allows you to control who can access verification workflows using rules based on country, IP address, email address, or domain.

Above Start flow, select Restrict beside Anyone can start to choose an access restriction list. The list is evaluated when a session is created, before verification steps run.

The access panel shows the selected list's scope. You can manage lists in the access restrictions list page.

Workflows - Apply an access restriction list before a verification session starts.

OTP verification and document autofill

Select Start flow to configure:

  • OTP verification: Verify the customer's email address, mobile number, or both with a one-time passcode.

  • Document autofill: Populate customer details from their identity document during the journey.

When a Lifecycle Trigger sends the workflow, entry indicators above Start flow show Manual or API alongside the associated triggers and their timing.

Compliance policies

Compliance Policies evaluate verification evidence against regulatory frameworks, industry requirements, or internal controls. Attach policies from the workflow details panel using Add policy. Not every workflow template includes policies.

Each policy shows its revision. When a newer revision is available, review it and update the attached policy from the details panel.

After a session completes, policy evaluation results appear under Policy Assurance. See Regulatory coverage for supported frameworks and jurisdictions.

Outcome rules and actions

Below Complete flow, choose how verification results translate into decisions and follow-up actions.

  • Use Outcome rules to evaluate check results and client attributes, then set the session outcome to Clear, Attention, or Rejected.

  • Add actions to the result lanes to update the client’s stage or open a review case for each outcome.

  • Configure Alert cases when a specific check result needs review, even if the overall session is Clear.

Workflows - Configure session decisions and follow-up actions after verification.

If no outcome rule matches, ComplyCube uses its default session result. Compliance policies are evaluated after outcome rules and can raise Attention. A team member's direct session outcome override takes precedence over automated outcomes.

See Outcome rules and actions for rule conditions, evaluation order, result lanes, and case settings.

Ongoing reviews and lifecycle triggers

Lifecycle Triggers connect workflows to ongoing customer due diligence. For example, a trigger can send a review workflow when a periodic review is due or an identity document approaches expiration.

View associated lifecycle triggers at the top of the workflow designer, or in the right-hand workflow details panel. Select a trigger to review its configuration, or open Lifecycle Triggers to manage events, client filters, actions, and approval requirements.

Lifecycle view

Select Lifecycle in the top bar to review or edit the journey in four columns:

Column
What it shows

Who can start

Access restrictions and Start flow settings.

Verification

The ordered verification steps.

Outcome

Result actions and alert cases.

What happens next

Associated lifecycle triggers and their events and actions.

Workflows (Lifecycle View) - Review entry controls, verification, decisions, and follow-up in one view.

Select a card to open its settings on the right. You can also add, reorder, or remove verification steps from this view.

Advanced settings

Open More (…) > Advanced settings to configure Client consent. This displays a consent screen asking the customer to agree to personal data processing before checks run.

Workflow versions

A workflow’s first version is created automatically. As you make changes in the workflow designer, select Save as draft to continue editing or Save new version to publish an updated configuration.

Each published version preserves its configuration and cannot be edited, giving you a clear version history and audit trail.

New published versions start Inactive, so you can review and test changes before activating them. Only one version can be Active at a time, and existing sessions remain on the version they started with.

Workflows - View all versions of your workflow template.

The editor checks configuration as you work. Save is disabled while validation errors remain, such as a missing country selection, a case without a template, or a rule referring to a removed step.

Workflow statuses

Status
Description

Draft

A configuration being created or edited before publication.

Inactive

A published version that is disabled or superseded.

Active

The published version available for use.

You control activation manually. Existing sessions remain on the version they started with.

A workflow used by a lifecycle trigger cannot be deactivated until it is removed from that trigger.

Import and export

Use More (…) > Export workflow to download a workflow configuration. Use Import workflow to load an exported configuration, including when copying a workflow between accounts or environments. Review the imported configuration and resolve validation issues before saving.

Workflow session

A workflow session records one customer's verification journey, including progress, captured information, check results, and the audit trail. Sessions can be started through the Portal, supported integrations, or Lifecycle Triggers.

See Workflow sessions and results for ways to start sessions, review evidence, and access results.

Session tracking

Review customer progress, verification checks, and the activity timeline in the Portal. The Flow setup tab shows the workflow version used by the session.

See Session tracking for details.

Session lifecycle

Sessions move through Started, Processing, Complete, Abandoned, or Cancelled states. The state describes progress through verification; it is separate from the session's decision outcome.

See Session lifecycle for state definitions and when customers can resume a session.

Session results

Review Clear, Attention, or Rejected outcomes alongside the supporting check and policy results. Results are available in the Portaland through the API, with webhooks for session notifications.

See Session results for default decision behavior, outcome rules, and manual overrides.

Dynamic workflows

Dynamic workflows let you build adaptive KYC onboarding and identity verification journeys. Combine Smart Forms, check configuration, and verification processing rules to tailor verification to each customer.

Collect relevant information, run appropriate checks, and support complex compliance requirements without rebuilding the entire journey.

Common use cases include:

  • Rule-based customer routing: Direct customers to different workflows based on their responses and your business or compliance rules.

  • Conditional data capture: Show additional questions, declarations, or document requests when configured conditions are met.

  • Enhanced due diligence: Route higher-risk customers to workflows with additional checks and jurisdiction-specific requirements.

  • Advanced post-processing: Apply custom processing logic to individual check results before workflow outcome rules determine the session outcome.

Contact your Account Manager to enable advanced post-processing or dynamic workflow rules.

Monitoring performance

Use workflow analytics to review completion, abandonment, failure rates, and average verification time, then identify where to improve the customer journey.

See Monitoring performance for guidance.

Best practices

Build verification journeys that are consistent, efficient, and easy to maintain:

  • Start with a template: Use a predefined workflow as your foundation, then review its checks and policies against your requirements.

  • Keep flows simple: Include only relevant checks and information requests to reduce customer effort and onboarding friction.

  • Test before publishing: Preview and test workflows end-to-end to confirm the customer experience, policy alignment, and data capture settings are correct.

  • Review decision logic: Check rule order and fallback behavior so automated outcomes reflect your intended decisions.

  • Manage versions carefully: Review and test each new version before activating it. Existing sessions retain the version they started with.

  • Connect results to operations: Use webhooks for downstream actions, cases for manual review, and Lifecycle Triggers for ongoing customer due diligence.

Frequently asked questions

When should I use Workflows instead of Direct Checks?

Use Workflows when you need a complete onboarding journey rather than a single standalone verification.

They are usually the better fit for regulated onboarding, multi-step KYC flows, and cases where you need policy-driven decisioning.

Use Direct Checks when you only need to run one check without the wider workflow layer.

What verification checks can I include in a workflow?

You can include any ComplyCube verification checks in a workflow.

Can I build KYC workflows without writing code?

Yes.

Start with a workflow template or build your own, then send customers a verification link from the Portal or integrate the workflow into your application.

Can I customize a workflow for different countries or risk levels?

Yes.

You can create multiple workflows to fit different use cases, countries, or risk levels.

For more complex requirements, you can use dynamic workflows, conditional rules, and policy logic to route customers into different verification paths based on jurisdiction, risk profile, or use case.

How do workflow sessions work?

A workflow session is created each time a customer starts a workflow journey.

It tracks customer progress, captured data, verification results, and the audit trail for that journey.

Can customers resume an incomplete workflow?

Yes, while the session is still active.

A customer can resume a started session from where they left off.

Once a session becomes abandoned or cancelled, it cannot be resumed and must be restarted.

How are workflow results and decisions returned?

Workflow results are available in the Portal, through the API, and through webhooks.

This supports both manual review and real-time downstream decisioning.

Can I add compliance policies and questionnaires to a workflow?

Yes.

You can add Smart Forms to collect extra customer data and declarations, and Compliance Policies to apply rule-based evaluation inside the same journey.

Can workflows open cases and update client stages automatically?

Yes.

Configure result lane actions for Clear, Attention, and Rejected outcomes. Use alert cases for selected check findings regardless of the overall session outcome.