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 API for employees or Request Verification (Candidates) 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:

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 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 guide.

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