# The Custom Integration type allows organizations to integrate identity verification with minimal setup and any system.

## How to Set Up Custom Integration on the Incode Workforce Dashboard

1. Navigate to the **Integrations** section in the Incode Workforce dashboard.
2. Click **Add Integration** and select **Custom Integration**.
3. Enter an **Integration Name** (required).
4. Optionally, provide a **Redirect URL**.
5. Click **Save**.
6. Once saved, an **Integration ID** is generated and displayed in the integration card.

## How to Use Custom Integration

### 1. Create Verification Link

To request a verification for a user, you need to generate a unique verification link using [Request Verification](https://workforce.developer.incode.com/docs/requesting-verification) API for employees or [Request Verification (Candidates)](https://workforce.developer.incode.com/docs/request-verification-copy) API for candidates. Once generated, the verification link can be sent to your users via email or integrated with automation tools.

Verification link usually looks like this:

```undefined
https://icd.sh/03ymltf
```

### 2. Send Verification

- Share the generated verification URL with the employee via email, SMS, or internal communication channels.
- The employee clicks the link to start the verification process.
- This verification link can also be embedded into your systems programmatically for seamless integration.

### 3. Get Webhook Notification

- Once verification is completed, a webhook event is triggered.
- The system should listen for the following webhook events:
  - `verification.started`
  - `verification.succeeded`
  - `verification.failed`
- If the `correlation_id` parameter was set in the verification URL, it will be included in the webhook payload.
- Details about supported events, formats, and setup instructions can be found in the [Webhook Notifications](https://workforce.developer.incode.com/docs/webhooks) guide.

### 4. Fetch Verification Results (Backend-to-Backend)

- The verification results can be retrieved via the Incode API using the verification_id received in the webhook.
- The response will contain verification status, extracted identity details, and associated metadata.
- Instructions on how to obtain results are given in the [Fetching Verification Results](https://workforce.developer.incode.com/docs/fetching-verification-results) guide.

Here is a flow diagram of how this can be integrated with any ticketing system or automation tool.