Integrations and ConnectorsConnectorsSetup GuidesFraud & Risk

Alloy Connector

This connector integrates with Alloy to provide identity verification and fraud monitoring through Alloy's Journey and Events APIs.

Descope's Alloy connector lets you submit entities to Alloy Journeys and send lifecycle events for ongoing monitoring, then branch your flows using the responses.

Configuring the Alloy Connector

To integrate the Alloy connector, follow the steps below:

  • Visit the Connectors page in the Descope Console.
  • Choose Alloy from the list of connectors.

Connector Setup

Configure the following fields:

  • Connector name: Assign a custom name for your connector, especially useful when using multiple connectors originating from the same template.
  • Connector description: (Optional) A short description of how you use this connector.
  • API token: The Alloy API token.
  • API secret: The Alloy API secret.
  • Base URL: The base URL for the Alloy API, for example: https://api.alloy.co/v1 (production) or https://sandbox.alloy.co/v1 (sandbox).

Alloy connector setup

Test & Save

  • Use the Test button to verify your configuration. The test performs an authenticated request to the Alloy API to confirm that the credentials and base URL are correct.
  • When the test succeeds, click Create to save the connector.

Implementing the Alloy Connector

Warning

Place Alloy connector steps after screens or actions that collect the identity and context fields you map into the connector (for example, name, email, address).

1. Select or Create a Flow

Navigate to Flows in the Descope Console and open an existing flow or create a new one.

2. Integration

Click the blue + icon in the flow builder and select Connector, then select the Alloy action steps.

Alloy connector flow

Alloy / Journey Application

Submits a person or business entity to an Alloy Journey for identity verification (KYC/KYB). You can map common identity fields from your flow context—such as first name, last name, email, phone, date of birth, address, and SSN—and supply any journey-specific fields that are not covered by explicit parameters through the Additional entity data object.

After a Journey Application step runs, you can access the results in the flow context under the key connectors.alloy_journeyApplication.

Alloy journey application response

For the complete response shape, see the Alloy Journey Applications API reference.

Alloy / Send Event

Sends lifecycle events to Alloy for ongoing monitoring. Supported event types include login, person_created, person_updated, transaction, credentials_updated, and others defined by Alloy. You must supply at least one entity identifier: either an external entity ID (your own id, such as the Descope login id used when the journey was created) or an entity token from Alloy’s journey response.

Important

Each event type can require specific fields in the Event data parameter. For example, a login event expects login_method with one of: biometric, password, passwordless, sso. See the Alloy Events API reference for type-specific requirements.

After Send Event, you can access the results in the flow context under the key connectors.alloy_sendEvent.

Alloy send event response

Refer to the Alloy Events API reference for full field documentation.

Was this helpful?

On this page