Identitycheck

11 tools available

IdentityCheck is a verification solution designed to authenticate user identities with precision and speed, utilizing advanced algorithms and comprehensive data sources to ensure accurate validation, mitigate fraud, and enhance security.

Connect Identitycheck to Definable to automate repetitive tasks, sync data with the rest of your stack, trigger on real-world events. Personas call Identitycheck's 11 tools directly from chat or scheduled flows. You can wire it into any persona to read, write, and react when an event fires.

Common workflows with Identitycheck

01

Trigger on event

  1. Listen for a new event
  2. Parse and validate the payload
  3. Take an action with the linked tool
02

Daily summary

  1. Pull yesterday's activity
  2. Summarise with the model of your choice
  3. Send the digest via email or Slack
03

Cross-tool sync

  1. Read records from one app
  2. Transform with a persona
  3. Write the result back via this integration

Identitycheck actions 11

Every Identitycheck action below is a callable tool any Definable persona can invoke.

Check API Health

Performs an API health check to verify endpoint availability and responsiveness. This tool sends an HTTP request to a specified endpoint and interprets a 200 OK response as indicating the API is UP. It handles both JSON and non-JSON responses (including HTML). Use this before other operations to confirm the API is reachable.

Delete configuration

Tool to delete an existing configuration. Use when you need to remove a configuration by its unique code.

Delete Notification Endpoint

Tool to delete a notification endpoint by its unique code. This operation is idempotent - it will succeed whether the endpoint exists or has already been deleted. Use when you need to remove a callback endpoint that receives webhook notifications for identity verification events.

Fetch All Configurations

Tool to fetch all existing configurations. Use when you need to list all customer configurations after authentication.

Fetch all notification endpoints

Fetches all configured notification endpoints (webhooks) for the IdentityCheck SDK. Use this to list all callback URLs that receive onboarding event notifications (START_ONBOARDING, END_ONBOARDING).

Fetch Configuration

Fetch a specific identity verification configuration by its code. Use this action when you need to: - Retrieve theme customizations (logo, colors, button styles) for a configuration - Get custom wordings/translations defined for different languages - Review configuration options like link validity, email sender name, or ID capture settings - Verify that a configuration exists before using it in an onboarding flow The configuration code is the unique identifier assigned when the configuration was created.

Fetch Notification Endpoint

Tool to fetch a notification endpoint by its code. Use when you need the current configuration of a specific callback endpoint.

Fetch Onboardings

Retrieves identity verification onboarding sessions with comprehensive filtering and pagination. An onboarding represents a customer's identity verification journey, tracking their progress from link creation through document capture and verification completion. Each onboarding has a unique link sent via email/phone/none, and transitions through states: CREATED → CLICKED → CAPTURE_ONGOING → SUCCESS/ERROR/EXPIRED. Use this to: - Monitor verification sessions by status, date range, or customer identifiers - Track onboarding completion rates and error patterns - Retrieve specific onboardings by UID or business-specific identifiers - Analyze notification delivery methods and their effectiveness Returns paginated results with statistics (total results, distinct users, captures per document). All filter parameters are optional; omit them to retrieve all onboardings. Example: Find all failed verifications due to network errors in January 2024

Get Document Content

Tool to retrieve base64-encoded document content. Use when you have an onboarding UID and document code.

Retrieve Onboarding Status

Retrieve the current status and results of an identity verification onboarding session. Use this tool to check the progress of an onboarding (CREATED, CLICKED, CAPTURE_ONGOING) or get final results (SUCCESS, ERROR, EXPIRED). Returns detailed analysis results, error causes, and CIS export data when available.

Update Configuration

Tool to update an existing configuration. Use when you need to modify properties of a configuration identified by code.

Frequently asked questions

What can I automate with Identitycheck on Definable?

Anything Identitycheck exposes through its API. Common security & identity tools workflows on Definable include automate repetitive tasks, sync data with the rest of your stack, trigger on real-world events. Personas can call any of the 11 Identitycheck tools directly, then chain the result into another integration without you writing code.

How does Identitycheck authentication work?

Identitycheck uses API_KEY on Definable. You connect once from the integrations page, scoped to the permissions you choose, and from then on any persona that has the integration enabled can act on your behalf. Tokens are encrypted at rest and rotated automatically.

Is the Identitycheck integration included in my Definable plan?

Yes — every Definable plan, including Starter, includes access to all 11 Identitycheck tools. You only need a separate Identitycheck subscription if Identitycheck itself charges per seat or per API call.

Is using Identitycheck through Definable secure?

Every call from a persona to Identitycheck is logged with the user, persona, prompt, and response. Tokens never leave Definable's secrets vault, scopes are configurable per persona, and you can revoke access at any time from the integration page.

How do I get started with Identitycheck on Definable?

Sign up for Definable, open the integrations page, find Identitycheck, and connect via OAuth or API key. You can immediately attach Identitycheck to any persona and start running workflows. The free Starter plan includes 5,000 credits/month.

What Identitycheck actions does Definable expose?

Definable exposes all 11 Identitycheck actions as callable tools — including `Check API Health`, `Delete configuration`, `Delete Notification Endpoint`, plus 8 more. Each tool gets a typed parameter schema so personas know exactly how to call it.

Ready to automate with Identitycheck?

Wire it up in minutes. No coding required.

← All integrations