Kadoa is an API-first platform that enables users to create, manage, and monitor data extraction workflows from unstructured data sources.
Kadoa is an API-first platform that enables users to create, manage, and monitor data extraction workflows from unstructured data sources. On Nagent, Kadoa is exposed as a fully-configurable ai web scraping integration that any agent can call — 77 actions, and API key authentication. No code is required to wire Kadoa into your workflow — connect it once via the External Integrations panel and reuse it across every agent you build.
Agent builders use Kadoa to automate the kinds of tasks ai web scraping teams previously handled manually. Concrete examples — each one is a single agent step in Nagent — include:
Every action and trigger is paired with a structured input/output schema (visible in the sections below), so when you wire Kadoa into Helix — our agentic agent builder — the editor knows exactly what each step expects and produces. Configure once, deploy anywhere across your Nagent agents.
Every operation an agent can call against Kadoa, with input parameters and output schema. Drop these into any step of an agent built in Helix.
KADOA_APPROVE_BULK_VALIDATION_RULESTool to bulk approve preview validation rules for a workflow. Use after generating validation rules to activate multiple rules at once.
Input parameters
Array of rule IDs to approve. Must contain at least one rule ID.
The unique identifier of the workflow containing the rules to approve.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
KADOA_CREATE_CRAWL_CONFIGTool to create a new crawling configuration in Kadoa. Use when you need to configure a custom crawl with specific options like navigation settings, extraction rules, or artifact capture preferences.
Input parameters
Single URL to start crawling (for backward compatibility)
Internal: Job ID for workflow tracking
Internal: Data key for Parquet storage path
Whether this is a raw data mode crawl
Timeout in milliseconds
Maximum crawling depth
Maximum number of pages to crawl
Enable safe mode for crawling
Blueprint fields applied during crawling
Type of proxy to use
List of URLs for crawling
Whether to load images during crawling
Maximum number of matched pages to crawl before stopping
Webhook URL for completion notifications
Number of concurrent crawlers
Crawl method configuration.
Country for proxy selection
Whether to stay within the same domain
Internal: Billing source identifier
Output options for raw mode.
Regex patterns to include specific full URLs. Accepts array or JSON-stringified array of regex source strings.
Match threshold override for blueprint filtering
Regex patterns to exclude specific full URLs. Accepts array or JSON-stringified array of regex source strings.
Artifact capture options for crawled pages.
Extraction-related options derived from legacy launch summary.
Navigation-related options derived from legacy launch summary.
Whether to run preprocessing and extraction during the crawl phase
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
KADOA_CREATE_NOTIFICATION_CHANNELTool to create a notification channel for alerts delivery.
Input parameters
Human-readable name for the notification channel
Channel-specific configuration object. Required fields vary by channelType: EMAIL requires {'recipients': \['email@example.com'\]}; SLACK requires {'webhookUrl': 'https://hooks.slack.com/...'}; WEBHOOK requires {'webhookUrl': 'https://...', 'httpMethod': 'POST' or 'GET'}; WEBSOCKET requires {'endpoint': 'wss://...'}
Type of the notification channel
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
KADOA_CREATE_SCHEMACreate a new data schema with specified fields and entity type. Use this tool to define a reusable schema for data extraction workflows. Schemas can have Data Fields (typed data like STRING, NUMBER), Raw Content Fields (HTML/Markdown), or Classification Fields (predefined categories). Note: Field names must be camelCase (start lowercase, letters/numbers only). STRING dataType fields require an example value.
Input parameters
Name of the schema (1-255 characters)
Entity type for the schema (e.g., 'product', 'article'). Required for schemas with structured data fields.
Schema fields for extraction - choose from Data Field (typed data), Raw Content Field (HTML/Markdown), or Classification Field (predefined categories). At least one field is required.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
KADOA_CREATE_SUPPORT_ISSUETool to create a support ticket in Kadoa. Use when you need to report bugs, request features, or get help with workflows or integrations. User information is automatically inferred from the authentication context.
Input parameters
Optional array of files to attach to the issue
Title of the support issue
Category of the issue: 'bug' for bugs, 'feature' for feature requests, 'workflow_issue' for data extraction problems, 'integration' for integration issues
Priority level from 0 (lowest) to 4 (highest)
Optional workflow ID to link the issue to a specific workflow
Detailed description of the issue
Subcategory for workflow or integration issues.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
KADOA_CREATE_WORKFLOW_TRIGGERTool to create a trigger that fires when a source workflow emits an event. Use when you need to chain workflows together, triggering one workflow based on events from another. Common use case: trigger data processing workflow when scraping workflow finishes.
Input parameters
Whether the trigger is enabled. Set to false to temporarily disable without deleting.
Event type that triggers the target workflow. Most common: 'workflow_finished' to trigger when source completes successfully.
ID of the source workflow that will emit events to trigger the target workflow
ID of the workflow to trigger when the source workflow emits an event
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
KADOA_DELETE_ALL_VALIDATION_RULESTool to soft-delete all validation rules for a specific workflow with optional audit trail. This is a bulk operation that marks rules as deleted without permanently removing them. Use when reconfiguring workflows or cleaning up validation rules.
Input parameters
Optional reason for deletion to maintain audit trail. Must be between 1 and 500 characters if provided.
The unique identifier of the workflow whose validation rules should be deleted
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
KADOA_DELETE_CRAWL_CONFIGTool to delete a crawling configuration by its config ID. Use when you need to remove an existing crawl configuration.
Input parameters
Unique identifier of the crawl configuration to delete
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
KADOA_DELETE_NOTIFICATION_CHANNELTool to delete a notification channel by its ID. Use when you need to remove a channel that is no longer needed.
Input parameters
Unique identifier (UUID) of the notification channel to delete
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
KADOA_DELETE_SCHEMATool to delete a schema and all its revisions. Use when you need to permanently remove a schema from your Kadoa account. This operation cannot be undone.
Input parameters
Unique identifier (UUID) of the schema to delete. This will delete the schema and all its revisions permanently.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
KADOA_DELETE_VALIDATION_RULETool to delete a validation rule from a Kadoa workflow. Performs a soft delete with optional audit reason.
Input parameters
Optional reason for deleting the rule, used for audit trail. Maximum 500 characters.
The unique identifier (UUID) of the validation rule to delete.
The workflow ID associated with the validation rule. Required for authorization and validation.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
KADOA_DELETE_VALIDATION_RULES_BULKTool to bulk delete multiple validation rules for a workflow. Use when you need to remove multiple rules at once instead of deleting them individually.
Input parameters
Optional reason for deleting these rules. Maximum length is 500 characters.
Array of rule IDs (UUIDs) to delete. Must contain at least one rule ID.
The unique identifier (UUID) of the workflow containing the rules to delete.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
KADOA_DELETE_WORKFLOWDelete a workflow permanently from your Kadoa account. Use this tool when you need to permanently remove a workflow. This action cannot be undone.
Input parameters
Unique identifier of the workflow to delete (UUID format)
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
KADOA_DELETE_WORKFLOW_TRIGGERTool to delete a trigger from a Kadoa workflow. Use when you need to remove a specific trigger configuration. This action cannot be undone.
Input parameters
Unique identifier of the trigger to delete (UUID format)
Unique identifier of the workflow (UUID format)
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
KADOA_DISABLE_VALIDATION_RULETool to disable a validation rule with a mandatory reason. Use when you need to temporarily or permanently deactivate a data validation rule.
Input parameters
The reason for disabling the validation rule. Must be between 1 and 500 characters.
The unique identifier (UUID) of the validation rule to disable. Obtain this from the List Validation Rules action.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
KADOA_ENABLE_DATA_VALIDATIONTool to enable data validation on a specified workflow. Use after creating or updating a workflow to enforce its validation rules.
Input parameters
The unique identifier (UUID) of the workflow to enable data validation for. Obtain this from the GET /workflows endpoint.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
KADOA_EXECUTE_BULK_WORKFLOW_OPERATIONSExecute actions on multiple workflows at once. Use when you need to perform the same operation on many workflows efficiently. Best-effort processing: each workflow is processed independently, so some may succeed while others fail. Check the response to see individual results and summary statistics. Supported actions: run, pause, resume, delete, approve, assignTags.
Input parameters
The action to perform on all workflows: run (start workflow), pause (stop workflow), resume (restart paused workflow), delete (remove workflow), approve (approve pending workflow), assignTags (assign tags)
Action-specific parameters for bulk operations.
Array of workflow IDs to operate on (max 50)
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
KADOA_EXPORT_ACTIVITYTool to export activity events from audit logs to CSV format for compliance and audit purposes. Use when you need to retrieve historical activity data, generate audit reports, or track user actions across workflows. Supports filtering by time range, user, workflow, event types, and other criteria.
Input parameters
Maximum number of activity records to export. If not specified, all matching records are returned.
Number of records to skip before starting export (for pagination)
Filter activity events by specific user ID who triggered the action
Filter events up to this date (ISO 8601 format, e.g., 2024-12-31T23:59:59Z)
Filter events from this date onwards (ISO 8601 format, e.g., 2024-01-01T00:00:00Z)
Comma-separated list of event types to include (e.g., 'workflow_started,workflow_finished')
Comma-separated list of interfaces to filter by (e.g., 'api,ui,webhook')
Filter activity events by specific workflow ID (UUID format)
Relative time window counted backwards from now (e.g., '6h' for 6 hours, '1d' for 1 day, '2w' for 2 weeks). Mutually exclusive with startDate/endDate.
Comma-separated list of resource types to filter by (e.g., 'workflow,user,account')
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
KADOA_EXPORT_ACTIVITY_WORKFLOWSTool to export workflow configurations and metadata as CSV for portfolio reviews and compliance reporting. Use when you need to generate compliance reports or review workflow activity across a specific time period. Returns CSV data containing workflow details, states, and activity metadata.
Input parameters
Time range filter for workflow export. Filters workflows by their creation or activity date within the specified timeframe.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
KADOA_FETCH_WORKFLOW_CONFIGURATIONRetrieve detailed configuration of a workflow by its ID. Returns workflow metadata, extraction schema, scheduling settings, data validation config, and run status. Use this to inspect a workflow's setup or check its current state.
Input parameters
Unique identifier of the workflow to retrieve (UUID format)
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
KADOA_GET_ALL_LOCATIONSRetrieves all available scraping proxy locations (countries) supported by Kadoa. Returns ISO country codes (e.g., US, GB, DE) that can be used when configuring workflows to scrape from specific geographic regions. Use this to see which locations are available before creating location-specific scraping workflows.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
KADOA_GET_CRAWL_BUCKET_DATATool to retrieve file content from the Kadoa crawling bucket (HTML or screenshot). Use when you need to access raw files stored during a crawl session.
Input parameters
Base64-encoded filename of the file to retrieve from the crawling bucket. Obtain this from crawl session pages (e.g., from GET /v4/crawl/{sessionId}/pages). The filename typically includes the session ID and file type (html/screenshot).
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
KADOA_GET_CRAWL_CONFIGTool to retrieve a crawling configuration by its ID. Use when you need to view the detailed settings of an existing crawl configuration.
Input parameters
Unique identifier of the crawling configuration to retrieve
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
KADOA_GET_CRAWLED_PAGE_CONTENTTool to retrieve content of a crawled page. Use when you need the HTML or Markdown of a page from a specific crawling session.
Input parameters
Desired output format: 'html' for HTML content or 'md' for Markdown content. Defaults to 'html'
Unique ID of the crawled page. Obtain this from the GET /crawl/{sessionId}/pages endpoint
Unique ID of the crawling session. Obtain this from the POST /crawl endpoint or GET /crawl/{sessionId}/status
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
KADOA_GET_CRAWLED_PAGESTool to list pages crawled during a session. Use when you need to paginate through results after starting a crawl session.
Input parameters
Number of items per page for pagination
Unique identifier of the crawling session returned from POST /v4/crawl
Current page number for pagination, starts at 1
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
KADOA_GET_CRAWL_STATUSTool to fetch current status of a crawling session. Use when you need to check progress of a crawl by its session ID.
Input parameters
UUID of the crawling session returned from POST /v4/crawl (start crawl session)
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
KADOA_GET_EVENT_TYPETool to retrieve details for a specific notification event type. Use when you need to understand the schema, description, or configuration of a particular event type for setting up notifications.
Input parameters
Event type identifier to retrieve details for. Common examples: workflow_started, workflow_finished, workflow_failed, workflow_sample_finished, workflow_data_change, system_maintenance, service_degradation, credits_low, free_trial_ending.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
KADOA_GET_EVENT_TYPESTool to retrieve supported notification event types. Use when you need to enumerate available notification triggers.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
KADOA_GET_LATEST_WORKFLOW_DATARetrieves the extracted data from a Kadoa workflow's most recent run (or a specific run if runId is provided). Returns paginated records in JSON or CSV format. Use Get Workflows action first to obtain a valid workflowId.
Input parameters
Enable gzip compression for the response
Page number for pagination (starts at 1)
Number of items per page. Use 0 to retrieve all items (streaming mode).
Sort direction: 'asc' for ascending, 'desc' for descending
Optional UUID of a specific workflow run. If omitted, returns data from the most recent run.
Response format: 'json' returns structured data, 'csv' returns raw CSV text
Field name to sort results by (e.g., a schema field from the workflow)
Optional list of filter objects to narrow down results by field values
The unique identifier (UUID) of the workflow. Obtain this from the Get Workflows action.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
KADOA_GET_LATEST_WORKFLOW_VALIDATIONRetrieves the latest validation results for the most recent job of a workflow. Returns comprehensive validation data including anomaly counts, detailed anomaly lists by rule, schema issues, and change detection summaries.
Input parameters
Identifier of the workflow to fetch the latest validation for
Whether to include dry-run validation results
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
KADOA_GET_NOTIFICATION_CHANNELTool to retrieve details of a specific notification channel. Use when you have a channel's ID and need its configuration.
Input parameters
Unique identifier (UUID) of the notification channel to retrieve
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
KADOA_GET_NOTIFICATION_LOGSTool to retrieve notification event logs with optional filtering by workflow, event type, and date range. Use when you need to audit notification delivery, troubleshoot missing notifications, or review event history.
Input parameters
Number of events to return per page (1-100, default 50)
Number of events to skip for pagination (default 0)
Filter events until this date (optional). ISO 8601 format recommended.
Filter by event type (optional). Common types include: workflow_started, workflow_finished, workflow_failed, workflow_sample_finished, workflow_data_change, system_maintenance, service_degradation, credits_low, free_trial_ending.
Filter events from this date (optional). ISO 8601 format recommended.
Filter by workflow ID (optional). Obtain this from the KADOA_GET_WORKFLOWS action.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
KADOA_GET_NOTIFICATION_SETTINGRetrieves a specific notification setting by its unique identifier. Use this tool to fetch details about how notifications are configured for specific events and which channels are linked. Returns the event type, enabled status, linked channels, and timestamps.
Input parameters
Unique identifier (UUID) of the notification setting to retrieve. Obtain this from creating a notification setting or listing existing settings.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
KADOA_GET_SCHEMARetrieve a specific schema by its unique identifier. Returns schema metadata, field definitions, and configuration. Use this to inspect available data structures or validate schema configurations for workflows.
Input parameters
Unique identifier (UUID) of the schema to retrieve
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
KADOA_GET_VALIDATION_ANOMALIESTool to retrieve all anomalies for a specific validation. Use this when you need to fetch detailed anomaly data detected during a data validation run, grouped by validation rules with pagination support.
Input parameters
Page number for pagination, must be >= 1
Number of items per page, between 1 and 100
Unique identifier of the validation to fetch anomalies for
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
KADOA_GET_VALIDATION_ANOMALIES_BY_RULETool to retrieve anomalies for a specific validation rule. Use this to investigate specific rule violations and understand what data failed validation checks.
Input parameters
Page number for pagination, must be ≥ 1
Number of items per page, between 1 and 100
The rule name to filter anomalies by (will be URL encoded automatically)
The unique identifier of the validation to retrieve anomalies for
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
KADOA_GET_VALIDATION_CONFIGTool to retrieve the data validation configuration for a specific workflow. Use this to check validation status, alerting thresholds, and rule counts before modifying validation settings.
Input parameters
The unique identifier of the workflow to retrieve validation configuration for
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
KADOA_GET_VALIDATION_RULETool to retrieve a specific validation rule by its ID. Use this to inspect rule details including configuration, status, and metadata.
Input parameters
The unique identifier of the validation rule to retrieve
Whether to include soft-deleted rules (admin only). Note: API has strict boolean validation.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
KADOA_GET_WORKFLOW_AUDIT_LOGRetrieve audit log entries for a workflow. Use when you need to track changes and operations performed on a workflow. Returns paginated log entries showing operation type, user information, and changed values.
Input parameters
Page number for pagination (starts at 1)
Number of items per page (1-100)
The unique identifier of the workflow. Obtain this from the Get Workflows action
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
KADOA_GET_WORKFLOW_JOBTool to retrieve the current status and telemetry information for a specific workflow job. Use when you need to check the execution status, errors, or metadata of a particular job run.
Input parameters
The unique identifier of the job. Obtain this from the Get Workflow Run History action
The unique identifier of the workflow. Obtain this from the Get Workflows action
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
KADOA_GET_WORKFLOW_RUN_HISTORYTool to fetch workflow run history. Use when you need to retrieve past run records for a workflow after execution.
Input parameters
The unique identifier of the workflow. Obtain this from the KADOA_GET_WORKFLOWS action
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
KADOA_GET_WORKFLOWSRetrieve a paginated list of workflows with optional filtering. Use this tool to list all workflows in your Kadoa account. You can filter by: - search: Find workflows by name, URL, or ID - state: Filter by workflow state (ACTIVE, PAUSED, ERROR, etc.) - monitoring: Filter by whether monitoring is enabled Returns workflow details including name, state, URLs, schema, and run statistics.
Input parameters
Number of items to skip (offset) for pagination, must be >= 0
Maximum number of workflows to return per page (1-100)
Filter by workflow state (e.g., ACTIVE, PAUSED, ERROR)
Search term to filter workflows by name, URL, or ID
Filter workflows by monitoring status. True returns only monitored workflows, False returns only non-monitored workflows.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
KADOA_GET_WORKFLOW_TRIGGERTool to retrieve a specific trigger for a workflow. Use this when you need to inspect trigger details including its configuration and status.
Input parameters
The unique identifier of the trigger to retrieve
The unique identifier of the workflow
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
KADOA_GET_WORKFLOW_VALIDATION_RESULTSRetrieves the latest validation results for a specific workflow job. Returns validation details including anomalies detected, rules executed, and schema issues. Returns has_results=false if no validation results exist for the specified job.
Input parameters
Identifier of the job within the workflow
Identifier of the workflow to fetch validation results for
Whether to include dry-run validation results
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
KADOA_GET_WORKSPACE_DETAILSTool to retrieve detailed information about a workspace (user, team, or organization). Use when you need to get workspace metadata including name, type, email, feature flags, and team information.
Input parameters
Workspace ID (user, team, or organization). This is the unique identifier for the workspace whose details you want to retrieve.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
KADOA_LIST_ACTIVITYTool to retrieve activity events from audit logs with basic filtering and pagination. Use when you need to track workflow events, user actions, or system activities. Supports time-based filtering (absolute or relative), event type filtering, and resource filtering.
Input parameters
Maximum number of activity events to return per page
Number of items to skip (offset) for pagination, must be >= 0
Filter by user ID to show only activity events performed by a specific user
Filter events that occurred on or before this date (ISO 8601 format or epoch timestamp)
Filter events that occurred on or after this date (ISO 8601 format or epoch timestamp)
Comma-separated list of event types to filter by (e.g., 'workflow_created,workflow_updated')
Comma-separated list of request sources to filter by (e.g., SYSTEM, UI, SDK, API) - filters by requestSource field
Filter by workflow ID to show only activity events related to a specific workflow
Relative time window counted backwards from now (e.g., 6h for last 6 hours, 1d for last day, 2w for last 2 weeks)
Comma-separated list of resource types to filter by (e.g., WORKFLOW, DATA_QUALITY_RULE, SCHEMA, NOTIFICATION_CHANNEL)
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
KADOA_LIST_CHANGESTool to retrieve all data changes detected across workflows in your Kadoa account. Use this when you need to monitor what data has changed in your workflows over time. You can filter changes by workflow IDs, date range, and paginate through results.
Input parameters
Number of records to skip for pagination (offset). Must be >= 0.
Number of records to return per page. Must be >= 1.
End date to filter changes in ISO 8601 format (e.g., '2024-12-31T23:59:59Z'). Only changes detected on or before this date will be returned.
Comma-separated list of fields to exclude from each change object (e.g., 'data,differences'). Use this to reduce response size when you don't need all fields.
Start date to filter changes in ISO 8601 format (e.g., '2024-01-01T00:00:00Z'). Only changes detected on or after this date will be returned.
Comma-separated list of workflow IDs to filter changes. If not provided, returns changes for all ACTIVE workflows.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
KADOA_LIST_CRAWL_SESSIONSTool to retrieve a paginated list of crawling sessions with optional filtering. Use when you need to view all crawl sessions or filter by user ID.
Input parameters
Page number for pagination, starts at 1
Filter sessions by user ID
Number of items per page
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
KADOA_LIST_JOB_VALIDATIONSTool to list all validation runs for a specific job with pagination support. Use when you need to retrieve the full validation history for a job, not just the latest result.
Input parameters
Page number for pagination, must be ≥ 1
The unique identifier of the job within the workflow
Number of items per page, between 1 and 100
The unique identifier of the workflow
Include dry run validations in results
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
KADOA_LIST_NOTIFICATION_CHANNELSTool to retrieve all notification channels configured for the account. Use when you need to list available channels for alerts delivery.
Input parameters
Workflow ID (optional, if provided returns channels linked to this workflow)
Include linked notification configurations with workflow information
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
KADOA_LIST_NOTIFICATION_SETTINGSTool to retrieve all notification settings, with optional filtering by workflow ID or event type. Use when you need to list configured notifications or check existing settings before creating new ones.
Input parameters
Filter settings by event type. If omitted, returns settings for all event types.
Workflow ID(s) to filter settings. Can be a single ID, comma-separated IDs, or 'null' for workspace-level settings.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
KADOA_LIST_SCHEMASTool to retrieve all schemas accessible by the authenticated user. Use this when you need to see available schema definitions or find a specific schema by name or entity type.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
KADOA_LIST_SUPPORT_STATESTool to retrieve available support issue states. Use when you need to see what states can be assigned to support tickets.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
KADOA_LIST_VALIDATION_RULESTool to list all data validation rules with optional pagination and filtering.
Input parameters
Page number for pagination, must be ≥ 1
Filter rules by status
Group ID to filter validation rules
Number of items per page, between 1 and 100
Workflow ID to filter validation rules. Optional; if omitted returns rules across workflows.
Whether to include soft-deleted rules (admin only)
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
KADOA_LIST_WORKFLOW_TRIGGERSTool to get all triggers where the specified workflow is the source. Use when you need to retrieve the list of triggers associated with a workflow, such as understanding what actions or workflows are triggered by this workflow's execution.
Input parameters
Unique identifier of the source workflow (UUID format). Obtain this from the KADOA_GET_WORKFLOWS action
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
KADOA_PAUSE_CRAWL_SESSIONTool to pause an active crawling session. Use when you need to temporarily stop a running crawl without terminating it completely.
Input parameters
ID of the crawling session to pause
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
KADOA_PAUSE_WORKFLOWTool to pause a running or scheduled workflow. Use when you need to temporarily stop a workflow from executing. The workflow will remain paused until explicitly resumed or reactivated.
Input parameters
The unique identifier of the workflow to pause. Obtain this from the Get Workflows action.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
KADOA_POST_ADVANCED_WORKFLOWTool to create an advanced workflow. Use when you need a valid advanced workflow ID before updating steps.
Input parameters
Optional user-friendly name for the new advanced workflow
Optional maximum number of steps allowed in the workflow
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
KADOA_POST_CRAWLStarts a new web crawling session to crawl and index pages from a website. Use this tool when you need to: - Crawl an entire website or specific sections - Gather page content for extraction or analysis - Index multiple pages from a domain Returns a session_id that can be used with get_crawl_status to monitor progress and get_crawled_pages to retrieve the crawled content.
Input parameters
URL to start crawling, must be a valid URI
Maximum crawling time in milliseconds, e.g., 1800000 for 30 minutes
Maximum depth to traverse during the crawl
Maximum number of pages to crawl
Multiple start URLs (mutually exclusive with 'url'). Must belong to same domain/subdomain
Country code for proxy configuration, e.g., 'DE'
Restrict crawler to the exact domain without subdomains
List of path patterns to include in the crawl
List of path patterns to exclude from the crawl
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
KADOA_POST_NOTIFICATION_SETTINGTool to create a notification setting linking channels to events. Use when subscribing workflows or workspace-level notifications to specific events.
Input parameters
Whether the subscription is active. Defaults to true.
Type of event to subscribe to.
List of notification channel IDs to link with this setting.
Workflow ID to scope the setting; omit for a workspace-level setting.
Configuration object for the event. Currently accepts an empty object; reserved for future extensions.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
KADOA_POST_NOTIFICATION_TESTSends a test notification event to verify notification channel configurations are working correctly. Use this tool to test that your notification channels (email, Slack, Teams, webhooks, etc.) are properly configured before relying on them for production workflows. The test sends a simulated event of the specified type, which will be delivered to all configured notification channels for that event type.
Input parameters
The type of notification event to simulate. Options: 'workflow_data_change' (triggered when workflow data changes), 'workflow_sample_finished' (triggered when a sample extraction completes), 'workflow_finished' (triggered when a workflow run completes), 'workflow_failed' (triggered when a workflow fails), 'workflow_validation_anomaly_change' (triggered when validation detects anomalies).
Optional workflow ID to associate with the test notification event. When provided, the test notification will include this workflow ID in its payload.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
KADOA_POST_WEBHOOK_SUBSCRIPTIONTool to subscribe to specified webhook events. This will create a webhook channel and then create notification settings for the provided events linking that channel.
Input parameters
List of event names to subscribe to. Valid event types include: workflow_started, workflow_finished, workflow_failed, workflow_export_completed, workflow_sample_finished, workflow_data_change, workflow_validation_anomaly_change, system_maintenance, service_degradation, credits_low, free_trial_ending. Use GET /v5/notifications/event-types to fetch the full list.
Destination URL for webhook deliveries
Optional workflow ID to scope the subscription. Omit for workspace-level.
Optional name for the created webhook channel. If omitted, a default will be used.
HTTP method to use when sending the webhook
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
KADOA_POST_WORKFLOWCreate a new Kadoa web scraping workflow. This tool creates a workflow that can extract structured data from web pages. Provide URLs to scrape, specify a navigation mode, and define the data schema. For structured extraction: Use 'single-page' mode with entity + fields. For paginated content: Use 'paginated-page' mode. For AI-driven navigation: Use 'agentic-navigation' mode with userPrompt (Enterprise only). Note: Workflow creation may take 60+ seconds as Kadoa analyzes the target URLs.
Input parameters
Human-readable name of the workflow
Tags for categorization
List of URLs to scrape
Maximum number of items to scrape
Entity name for extraction; required unless using agentic-navigation or schemaId
Schema fields for extraction; required unless using agentic-navigation or schemaId
Update frequency for the workflow
Location configuration for scraping.
Reference an existing schema instead of providing entity/fields
If true, automatically start the workflow after creation
Cron expressions for custom schedules
Monitoring configuration object
Prompt for agentic-navigation; required when navigationMode is 'agentic-navigation'
Workflow description, max 500 characters
Browser interactions to perform before scraping
If true, bypass preview and install immediately
Navigation mode: 'single-page' for single URL extraction, 'paginated-page' for paginated lists, 'page-and-detail' for list+detail pages, 'agentic-navigation' for AI-driven (Enterprise only)
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
KADOA_POST_WORKFLOW_MONITORINGConfigure monitoring and scheduling for a Kadoa workflow to detect data changes. This tool allows you to: - Set up recurring workflow runs at specified intervals (daily, hourly, weekly, etc.) - Enable monitoring to detect when specific fields change (e.g., price changes, stock updates) - Configure conditions to filter which changes trigger notifications Use this after creating a workflow or to update an existing workflow's monitoring settings. The workflow must exist before you can configure its monitoring.
Input parameters
ISO 8601 datetime for the next scheduled run. If not provided, defaults to 1 hour from now. Example: '2025-01-25T14:00:00Z'
Cron expressions for custom schedules. Required only when updateInterval is 'CUSTOM'. Example: \['0 9 * * 1-5'\] runs at 9 AM on weekdays.
Configuration for workflow monitoring and change detection.
The unique identifier of the workflow to configure. Obtain this from the 'Get Workflows' or 'Create Workflow' actions.
How often the workflow should run. Common values: 'DAILY' for once per day, 'HOURLY' for every hour, 'WEEKLY' for once per week. Use 'CUSTOM' with schedules for cron-based scheduling.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
KADOA_POST_WORKFLOW_VALIDATION_RULEGenerate an AI-powered data validation rule for a Kadoa workflow. This tool uses AI to convert a natural-language description into a SQL-based validation rule that can detect data quality issues in workflow outputs. Prerequisites: - The workflow must have completed at least one successful job run - The workflow must have data validation enabled The generated rule will be created in 'preview' status for testing before activation. Use the List Validation Rules action to view created rules, and the Bulk Approve Validation Rules action to activate them.
Input parameters
Optional job ID to use for generating the rule. If not provided, the most recent completed job will be used.
A natural-language description of the data validation rule to generate. The AI will convert this into a SQL-based validation rule. Be specific about field names and conditions.
The unique identifier of the workflow to add a validation rule to. The workflow must have completed at least one job run successfully.
If true, the rule is created in preview mode for testing before activation. Defaults to creating rules in preview status.
Optional list of specific column names to target when generating the validation rule. If omitted, the AI may target any relevant columns based on the prompt.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
KADOA_PUT_NOTIFICATION_CHANNELTool to update an existing notification channel. Use when you need to modify channel details.
Input parameters
Human-readable name for the notification channel
Channel-specific configuration. For EMAIL: {'recipients': \['email@example.com'\]}. For SLACK: {'webhookUrl': 'https://hooks.slack.com/...'}. For WEBHOOK: {'webhookUrl': 'https://...', 'httpMethod': 'POST'}. For WEBSOCKET: {'endpoint': 'wss://...'}
Unique identifier (UUID) of the notification channel to update. Obtain this from the Create Notification Channel or Get Notification Channel actions.
Type of notification channel: EMAIL, SLACK, WEBHOOK, or WEBSOCKET
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
KADOA_RESUME_CRAWL_SESSIONTool to resume a paused crawling session. Use when you need to restart a crawl that was previously paused or stopped.
Input parameters
ID of the crawling session to resume
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
KADOA_RESUME_WORKFLOWResumes a paused, preview, or error workflow. Use when you need to activate a workflow that is not currently running. Cannot resume workflows in certain states; check workflow state first using Get Workflows action.
Input parameters
The unique identifier (UUID) of the workflow to resume. Obtain this from the Get Workflows action.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
KADOA_RUN_ADHOC_EXTRACTIONTool to synchronously extract data from a URL using a given template. Use after choosing the schemaId (custom or 'html', 'body', 'markdown').
Input parameters
The URL to scrape
Proxy location settings, including selection type and ISO country code.
Custom schema ID or one of 'html', 'body', 'markdown' to control output format
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
KADOA_RUN_WORKFLOWTool to trigger a workflow to run immediately. Use when you need to start a workflow execution on demand. Returns a job ID that can be used to track the execution status.
Input parameters
Optional limit for the number of records to process during this workflow execution
Optional variables to pass to the workflow execution. These variables can be used within the workflow for dynamic behavior.
The unique identifier (UUID) of the workflow to run. Obtain this from the Get Workflows action.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
KADOA_SCHEDULE_VALIDATION_JOBTool to schedule a data validation job for a specific workflow job. Use this to trigger validation rules on job data, detect anomalies, and ensure data quality. Supports custom SQL rules, dry-run mode, and idempotent validation IDs.
Input parameters
The unique identifier (UUID) of the job within the workflow to validate
If true, validation runs without persisting results. Useful for testing rules.
Strategy for data validation execution.
Optional LLM prompt used to generate or explain rules, for tracking purposes
The unique identifier (UUID) of the workflow to validate
Optional list of custom SQL validation rules to apply in addition to library rules
Client-provided validation ID (UUID) for idempotency. If omitted, server generates one.
If true, only custom rules will be used. If false or omitted, both library and custom rules are applied.
Internal flag: true when validation is triggered by workflow execution
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
KADOA_UNSUBSCRIBE_FROM_WEBHOOK_EVENTSUnsubscribe from webhook event notifications by deleting a notification setting. Use this tool when you need to: - Remove an existing notification subscription by its settings ID - Stop receiving webhook notifications for specific events - Clean up notification configurations The settings ID can be obtained from the response of the Subscribe to Webhook Events action or from listing notification settings.
Input parameters
The unique identifier (UUID) of the notification settings to delete. This ID is returned when creating notification settings via the POST /v5/notifications/settings endpoint or Subscribe to Webhook Events action.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
KADOA_UPDATE_NOTIFICATION_SETTINGSTool to update existing notification settings for events. Use when modifying notification configurations such as enabled status, event type, event configuration, or linked channels.
Input parameters
Whether the notification setting is active. Set to true to enable, false to disable.
Type of event to subscribe to.
Array of channel IDs to link to this settings. Updates the list of notification channels associated with this setting.
Unique identifier (UUID) of the notification setting to update. Obtain this from creating a notification setting or listing existing settings.
Settings specific to the event type. Currently accepts an empty object {}. This object will be extended in future releases to support event-specific configuration options.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
KADOA_UPDATE_SCHEMATool to update an existing Kadoa schema. Use when you need to modify schema metadata (name, entity) or update the field definitions. At least one of name, entity, or fields must be provided to update the schema.
Input parameters
Name of the schema (1-255 characters)
Entity type for the schema
Array of field definitions. Each field can be a DataField (with name, description, dataType), RawContentField (with name, fieldType='RAW_CONTENT', metadataKey), or ClassificationField (with name, fieldType='CLASSIFICATION', categories).
Unique identifier (UUID) of the schema to update
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
KADOA_UPDATE_VALIDATION_CONFIGTool to update the complete data validation configuration including alerting settings for a specific workflow. Use this to modify validation status, alert thresholds, and notification preferences.
Input parameters
The unique identifier of the workflow to update validation configuration for
Data validation configuration with alerting settings to update
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
KADOA_UPDATE_WORKFLOW_METADATATool to update workflow metadata such as name, description, tags, and configuration settings. Use when you need to modify an existing workflow's properties without recreating it.
Input parameters
The new name for the workflow
The tags for the workflow
List of target URLs for the workflow
The new limit for the workflow (maximum items to extract)
The new entity for the workflow
The new extraction schema for the workflow (required when switching from agentic-navigation to other modes)
Location configuration for the workflow.
Maximum crawl depth (only for crawler workflows, 1-200)
Maximum pages to crawl (only for crawler workflows, 1-100000)
Array of cron expressions for the workflow schedule
Monitoring configuration for the workflow.
User prompt for agentic navigation mode (required when switching to agentic-navigation, 10-5000 characters)
ID of the workflow to update
The new description for the workflow
Regex patterns to include specific paths (only for crawler workflows)
Additional static data for the workflow
Navigation mode for scraping. Switching between modes may require additional fields: to 'agentic-navigation' requires userPrompt (10-5000 characters), from 'agentic-navigation' to other modes requires schema and entity, to 'all-pages' requires all URLs to have the same hostname
Regex patterns to exclude specific paths (only for crawler workflows)
The new update interval for the workflow
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
KADOA_UPDATE_WORKFLOW_TRIGGERTool to update trigger properties including event type and enabled status. Use when you need to modify an existing workflow trigger's configuration.
Input parameters
Whether the trigger is enabled. Set to true to enable the trigger, false to disable it.
Event types for workflow triggers.
The unique identifier of the trigger to update.
The unique identifier of the workflow. Obtain this from the Get Workflows action.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
No publicly available marketplace agent is found using this tool yet. There are 32 agents privately built on Nagent that already use Kadoa.
Build on Nagent
Connect Kadoa to any Nagent agent in minutes — no API key management, no boilerplate. Just configure and deploy.
The five questions agent builders ask before adopting a new integration.
Open the External Integrations panel inside Nagent (app.nagent.ai/externalIntegration), find Kadoa, and click "Connect Now." You'll authenticate with an API key — Nagent handles credential storage and refresh automatically. Once connected, Kadoa is available to any agent in your workspace.
No. Nagent provides no-code integration for every tool. Once Kadoa is connected, you configure its 77 actions directly in the agent builder UI — no API calls, no boilerplate, no schema management.
Helix — Nagent's agentic agent builder — lets you drop Kadoa steps into any workflow visually. Pick an action (e.g., one of those listed above), fill in the inputs (Helix knows the required vs. optional schema for each parameter), and connect it to upstream/downstream steps. Triggers run as the entry point of an agent, so when a Kadoa event fires, the agent kicks off automatically.
Every Kadoa action and trigger ships with a fully-typed schema — input parameters with name, type, required flag, and description, plus the output payload shape. The schemas are documented in the sections above. Helix uses these schemas to validate your configuration at build time and to type-check the data flowing between steps.
Yes. While Kadoa ships with 77 pre-built ai web scraping actions, you can layer custom logic around them inside Helix — pre/post-processing steps, conditional branches, retries, or stitching Kadoa together with other connected tools. For deeper customization, talk to our team about Nagent's Agentic AI Lab — forward-deployed engineers who build Kadoa-based workflows tailored to your business.