Descope
Descope is a drag-and-drop CIAM platform that lets developers build authentication and identity flows visually, without code. The Descope Incode Connector adds biometric identity verification as a native step inside any Descope flow, useful for sign-up, step-up authentication on high-risk events, or identity verification during account recovery.
The connector is published and maintained by Descope. It is available in the Descope console connector library.
Use Cases
The integration supports the following use cases:
- Identity verification at customer sign-up
- Step-up verification for high-risk transactions or session events
- Identity confirmation during account recovery or password reset
- Compliance-driven IDV as part of a broader Descope authentication flow
Integration Flow
- When a user reaches an Incode/Verify step in a Descope flow, Descope redirects the user to Incode to complete the verification experience configured in your Incode Flow.
- After the user finishes, Incode redirects them back to the Descope flow and the connector response populates fields that Descope's flow builder can evaluate, including overall status and score.
- You use a condition step immediately after the connector to branch the flow based on the verification result. For example:
- Continue to sign-up completion if verification succeeded.
- Route the user to manual review or reject if verification failed.
The following output fields are available to downstream flow steps:
connectors.incode_verify.statusconnectors.incode_verify.data.statusconnectors.incode_verify.data.score.overall.status
Prerequisites
Ensure you have the following before you begin:
- An active Descope account with access to the Descope console
- An Incode account with API access
- An Incode API key
- An Incode flow ID configured for your verification use case
Set Up the Descope Integration
The full setup is documented in Descope's documentation. The steps below provide a summary.
Configure the Incode Connector in Descope
- In the Descope console, open the Connectors page.
- Select Incode from the list of available connectors.
- Enter the following values:
Field Value Connector name A display name for this connector: for example, Incode IDV SignupConnector description Optional description of the connector's purpose API Key Your Incode production API key API URL The base URL of the Incode API Flow ID The Incode flow ID to run when this connector is invoked
- Click Test to validate the configuration.
- Click Create to save.
Add the Incode Connector to a Descope Flow
- In the Descope console, open the Flows page.
- Select an existing flow or create a new one.
- Click the blue plus (+) icon inside the flow builder and select Connector.
- Choose your configured Incode connector.
Add a Condition Step to Handle the Result
Immediately after the Incode connector, add a Condition step. Use one of the connector output keys—for exampleconnectors.incode_verify.data.score.overall.status—to branch the flow based on whether verification succeeded, failed, or requires review.
Descope Documentation
For detailed screenshots, flow examples, and troubleshooting, see Descope's connector configuration guide.
