Trigger on event
- Listen for a new event
- Parse and validate the payload
- Take an action with the linked tool
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.
Every Identitycheck action below is a callable tool any Definable persona can invoke.
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.
Tool to delete an existing configuration. Use when you need to remove a configuration by its unique code.
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.
Tool to fetch all existing configurations. Use when you need to list all customer configurations after authentication.
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 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.
Tool to fetch a notification endpoint by its code. Use when you need the current configuration of a specific callback endpoint.
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
Tool to retrieve base64-encoded document content. Use when you have an onboarding UID and document code.
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.
Tool to update an existing configuration. Use when you need to modify properties of a configuration identified by code.
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.
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.
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.
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.
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.
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.
Wire it up in minutes. No coding required.