> ## Documentation Index
> Fetch the complete documentation index at: https://composio-preview.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Insighto.ai

> Insighto.ai is an AI-powered communication platform that enables businesses to create and deploy conversational AI chatbots and voice agents for enhanced customer engagement across multiple channels.

![Insighto.ai logo](https://mintcdn.com/composio-preview/tIuAovF9-7pXq2wA/images/toolkits/insighto_ai.svg?fit=max\&auto=format\&n=tIuAovF9-7pXq2wA\&q=85\&s=cffc523b9de5ee76ce8b5cbd0c6b0448)

* **Category:** ai chatbots
* **Auth:** API\_KEY
* **Composio-managed OAuth available?** N/A
* **Tools:** 65
* **Triggers:** 0
* **Slug:** `INSIGHTO_AI`
* **Version:** 20261101\_00

## Tools

> [accordion] Add Intent To Assistant
>
> **Slug:** `INSIGHTO_AI_ADD_INTENT_TO_ASSISTANT`
>
> Tool to add an intent to an assistant in Insighto.ai. Use when linking existing intents to an assistant for enhanced conversation handling.
>
> #### Input Parameters
>
> **intent\_id** `string` *required*
>
> The UUID id of the intent to add to the assistant
>
> **attributes** `object`
>
> Custom key/value attributes for this assistant-intent link
>
> **assistant\_id** `string` *required*
>
> The UUID id of the assistant
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create Agency
>
> **Slug:** `INSIGHTO_AI_CREATE_AGENCY`
>
> Tool to create a new agency in Insighto.ai. Use when setting up a new agency with organization-specific configuration and branding.
>
> #### Input Parameters
>
> **domain** `object`
>
> Optional domain configuration for the agency. Contains custom domain settings.
>
> **org\_id** `string` *required*
>
> Organization ID for the agency. Required to associate the agency with an organization.
>
> **branding** `object`
>
> Optional branding configuration for the agency. Contains logo, colors, and other visual customization.
>
> **user\_auth** `object`
>
> Optional user authentication configuration for the agency. Contains auth settings and providers.
>
> **billing\_plan** `object`
>
> Optional billing plan configuration for the agency. Contains billing-related settings and limits.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create Contact Custom Field
>
> **Slug:** `INSIGHTO_AI_CREATE_CONTACT_CUSTOM_FIELD`
>
> Tool to create a new contact custom field in Insighto.ai. Use when you need to add custom metadata fields for contacts.
>
> #### Input Parameters
>
> **org\_id** `string`
>
> Organization ID (optional). If not provided, uses default organization.
>
> **custom\_field\_name** `string` *required*
>
> Name of the custom field to create.
>
> **custom\_field\_type** `string` *required*
>
> Type of the custom field (e.g., 'string', 'number').
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create Form
>
> **Slug:** `INSIGHTO_AI_CREATE_FORM`
>
> Tool to create a new form in Insighto.ai. Use when you need to create either a natural (conversational AI-driven) or simple (traditional) form for collecting information from users.
>
> #### Input Parameters
>
> **name** `string` *required*
>
> Name of the form to create.
>
> **fields** `array`
>
> List of field definitions for the form. Each field can specify type, label, validation rules, etc.
>
> **org\_id** `string`
>
> Organization ID; defaults to API key's organization if not provided.
>
> **form\_type** `string ("natural" | "simple")` *required*
>
> Type of form to create. 'natural' for conversational forms with AI-guided interactions, 'simple' for traditional static forms.
>
> **attributes** `object`
>
> Custom key/value attributes for this form.
>
> **webhook\_id** `string`
>
> Webhook ID to associate with this form for triggering events.
>
> **trigger\_tools** `array`
>
> Tools that can be triggered during form interactions.
>
> **contact\_mapping** `object`
>
> Mapping configuration for contact fields in the form.
>
> **trigger\_instructions** `string` *required*
>
> Instructions that trigger or guide the form behavior. Describes what data to collect and how.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create Intent
>
> **Slug:** `INSIGHTO_AI_CREATE_INTENT`
>
> Tool to create a new intent in Insighto.ai. Use when adding custom intents before training or deployment. Call after confirming intent attributes.
>
> #### Input Parameters
>
> **name** `string` *required*
>
> Name of the intent to create.
>
> **is\_active** `boolean`
>
> Whether the intent is active; defaults to true.
>
> **attributes** `object`
>
> Custom key/value attributes for this intent.
>
> **description** `string`
>
> Optional human-readable description for the intent.
>
> **intent\_type** `string`
>
> Type of the intent; defaults to 'user'.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create Prompt
>
> **Slug:** `INSIGHTO_AI_CREATE_PROMPT`
>
> Tool to create a new prompt in Insighto.ai. Use when adding custom prompts for AI interactions. The prompt template can include variables in \{\{variable\_name}} format.
>
> #### Input Parameters
>
> **name** `string`
>
> Name of the prompt to create.
>
> **owner\_type** `string`
>
> Type of the owner for this prompt (e.g., 'user', 'organization').
>
> **description** `string`
>
> Optional human-readable description for the prompt.
>
> **prompt\_template** `string`
>
> The template text for the prompt. This is the actual content of the prompt.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create Provider
>
> **Slug:** `INSIGHTO_AI_CREATE_PROVIDER`
>
> Creates a new AI provider configuration (e.g., OpenAI, ElevenLabs, Azure Speech, Cartesia, PlayHT) for use in voice and text-to-speech workflows. The provider stores credentials and settings in the attributes field.
>
> #### Input Parameters
>
> **name** `string` *required*
>
> Provider display name
>
> **org\_id** `string`
>
> Organization ID under which the provider will be created
>
> **status** `boolean`
>
> Whether the provider is active or not
>
> **attributes** `object`
>
> Provider-specific configuration (e.g., API keys, voice IDs, regions). For ElevenLabs: voice\_id, model. For Azure Speech: subscription\_key, region. For PlayHT: api\_key, user\_id.
>
> **provider\_key** `string` *required*
>
> Unique key for the provider
>
> **provider\_name** `string ("openai" | "elevenlabs" | "azure_speech" | "cartesia" | "playht")`
>
> Identifier of the provider type
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create Tag
>
> **Slug:** `INSIGHTO_AI_CREATE_TAG`
>
> Tool to create a new tag in Insighto.ai. Use when categorizing contacts, conversations, or other entities with custom labels.
>
> #### Input Parameters
>
> **name** `string` *required*
>
> Name of the tag to create.
>
> **attributes** `object`
>
> Custom key/value attributes for the tag.
>
> **color\_code** `string` *required*
>
> Hex color code for the tag (e.g., #FF5733).
>
> **description** `string` *required*
>
> Description of the tag.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create Toolfunction
>
> **Slug:** `INSIGHTO_AI_CREATE_TOOLFUNCTION`
>
> Tool to create a new toolfunction in Insighto.ai. Use when you need to register a new tool function (SDK, CURL, or query index type) before using it in workflows or assistant operations.
>
> #### Input Parameters
>
> **name** `string` *required*
>
> Name of the toolfunction to create.
>
> **details** `object`
>
> Additional custom details or configuration for the toolfunction.
>
> **tool\_id** `string`
>
> Optional tool ID to associate with this toolfunction.
>
> **is\_enabled** `boolean`
>
> Whether the toolfunction is enabled or disabled. Defaults to false.
>
> **description** `string` *required*
>
> Description of the toolfunction and its purpose.
>
> **tool\_function\_type** `string ("sdk" | "curl" | "query_index")` *required*
>
> Type of the toolfunction. Must be one of: 'sdk', 'curl', or 'query\_index'.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create Webhook
>
> **Slug:** `INSIGHTO_AI_CREATE_WEBHOOK`
>
> Tool to create a new outbound webhook in Insighto.ai. Use when you need to configure webhook endpoints for event notifications.
>
> #### Input Parameters
>
> **name** `string` *required*
>
> Name of the webhook to create.
>
> **enabled** `boolean`
>
> Whether the webhook is enabled. Defaults to true.
>
> **endpoint** `string` *required*
>
> URL endpoint where webhook events will be sent. Must be a valid HTTP/HTTPS URL.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create Widget
>
> **Slug:** `INSIGHTO_AI_CREATE_WIDGET`
>
> Tool to create a new widget with specified attributes. Use after confirming assistant\_id and widget\_type.
>
> #### Input Parameters
>
> **name** `string`
>
> Internal name for the widget.
>
> **org\_id** `string`
>
> Organization ID; defaults to API key's organization.
>
> **attributes** `object`
>
> Custom key/value pairs for metadata.
>
> **bubble\_text** `string`
>
> Default text in bubble.
>
> **description** `string`
>
> Detailed description of the widget.
>
> **widget\_type** `string ("chat" | "html" | "whatsapp" | "phone" | "html_call" | "leadconnector" | "leadconnector_call" | "sms" | "fb_messenger" | "instagram" | "web_call" | "plivo_call" | "telnyx_call" | "telegram" | "render_form")` *required*
>
> Type of widget to create. Supported types: 'chat' (web chat), 'html' (embeddable HTML), 'whatsapp', 'phone', 'html\_call', 'leadconnector', 'leadconnector\_call', 'sms', 'fb\_messenger', 'instagram', 'web\_call', 'plivo\_call', 'telnyx\_call', 'telegram', 'render\_form'. Note: Some widget types (e.g., phone, telegram) may require additional provider setup.
>
> **assistant\_id** `string`
>
> Assistant ID to attach this widget to.
>
> **bubble\_color** `string`
>
> Hex code for bubble background.
>
> **display\_name** `string`
>
> Name shown to end users.
>
> **header\_color** `string`
>
> Hex code for header background.
>
> **style\_params** `object`
>
> Additional style overrides for provider.
>
> **intro\_message** `string`
>
> One-time welcome message.
>
> **action\_buttons** `array` *required*
>
> Quick action buttons displayed in the widget. Can be an array of strings (e.g., \['Yes', 'No']) or objects with 'label' and 'action' keys (e.g., \[\{'label': 'Help', 'action': 'help'}]).
>
> **bot\_icon\_color** `string`
>
> Hex code for bot avatar/icon.
>
> **ice\_break\_color** `string`
>
> Hex code for ice-break messages.
>
> **remove\_branding** `boolean`
>
> If true, hides Insighto.ai branding.
>
> **bot\_message\_color** `string`
>
> Hex code for bot message text.
>
> **header\_text\_color** `string`
>
> Hex code for header text.
>
> **user\_message\_color** `string`
>
> Hex code for user message text.
>
> **action\_buttons\_color** `string`
>
> Hex code for action button backgrounds.
>
> **textbox\_default\_text** `string`
>
> Placeholder text in input box.
>
> **user\_opening\_messages** `array` *required*
>
> Messages shown when the widget is first opened.
>
> **bot\_text\_message\_color** `string`
>
> Hex code for bot text messages.
>
> **user\_text\_message\_color** `string`
>
> Hex code for user text messages.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete Assistant By ID
>
> **Slug:** `INSIGHTO_AI_DELETE_ASSISTANT_BY_ID`
>
> Tool to delete an assistant by its ID. Use when you need to permanently remove an assistant from the system.
>
> #### Input Parameters
>
> **assistant\_id** `string` *required*
>
> The UUID id of the assistant to delete
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete Bulk Forms By IDs
>
> **Slug:** `INSIGHTO_AI_DELETE_BULK_FORMS_BY_IDS`
>
> Tool to delete multiple forms by their IDs in a single operation. Use when you need to remove multiple forms at once.
>
> #### Input Parameters
>
> **form\_ids** `array` *required*
>
> List of UUIDs of the forms to delete.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete Contacts In Bulk
>
> **Slug:** `INSIGHTO_AI_DELETE_CONTACTS_IN_BULK`
>
> Tool to delete multiple contacts in bulk. Use when you need to remove several contacts at once by providing their UUIDs.
>
> #### Input Parameters
>
> **contact\_ids** `array` *required*
>
> List of contact UUIDs to delete. Each must be a valid UUID format.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete Form By ID
>
> **Slug:** `INSIGHTO_AI_DELETE_FORM_BY_ID`
>
> Tool to delete a form by its unique identifier. Use when you need to permanently remove a form from the system.
>
> #### Input Parameters
>
> **form\_id** `string` *required*
>
> Unique identifier of the form to delete
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete Linked Assistant Datasource
>
> **Slug:** `INSIGHTO_AI_DELETE_LINKED_ASSISTANT_DATASOURCE`
>
> Tool to delete (unlink) a datasource from a linked assistant in Insighto.ai. Use when you need to remove a specific datasource from an assistant's knowledge base. Requires valid datasource\_id and assistant\_id.
>
> #### Input Parameters
>
> **assistant\_id** `string` *required*
>
> Unique identifier (UUID) of the assistant from which to unlink the datasource
>
> **datasource\_id** `string` *required*
>
> Unique identifier (UUID) of the datasource to delete
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete Link Tag Entity By ID
>
> **Slug:** `INSIGHTO_AI_DELETE_LINK_TAG_ENTITY_BY_ID`
>
> Tool to delete a link\_tag\_entity by its ID. Use when you need to remove a specific link\_tag\_entity from the system.
>
> #### Input Parameters
>
> **link\_tag\_entity\_id** `string` *required*
>
> Unique identifier of the link\_tag\_entity to delete
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete Prompt By ID
>
> **Slug:** `INSIGHTO_AI_DELETE_PROMPT_BY_ID`
>
> Tool to delete a prompt by its unique ID. Use when you need to remove a prompt from the system.
>
> #### Input Parameters
>
> **prompt\_id** `string` *required*
>
> Unique identifier of the prompt to delete
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete Provider By ID
>
> **Slug:** `INSIGHTO_AI_DELETE_PROVIDER_BY_ID`
>
> Delete an Insighto.ai AI provider configuration by its unique identifier.
>
> #### Input Parameters
>
> **provider\_id** `string` *required*
>
> Unique identifier of the provider to delete
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete Tag By ID
>
> **Slug:** `INSIGHTO_AI_DELETE_TAG_BY_ID`
>
> Tool to delete a tag by its unique identifier. Use when you need to permanently remove a tag from the system.
>
> #### Input Parameters
>
> **tag\_id** `string` *required*
>
> Unique identifier of the tag to delete
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete Tool By ID
>
> **Slug:** `INSIGHTO_AI_DELETE_TOOL_BY_ID`
>
> Tool to delete a tool by its ID. Use when you need to remove a tool from the system.
>
> #### Input Parameters
>
> **tool\_id** `string` *required*
>
> Unique identifier of the tool to delete
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete Toolfunction By ID
>
> **Slug:** `INSIGHTO_AI_DELETE_TOOLFUNCTION_BY_ID`
>
> Tool to delete a toolfunction by its ID. Use when you need to remove a toolfunction from the system.
>
> #### Input Parameters
>
> **toolfunction\_id** `string` *required*
>
> Unique identifier of the toolfunction to delete
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete Twilio Auth By ID
>
> **Slug:** `INSIGHTO_AI_DELETE_TWILIO_AUTH_BY_ID`
>
> Tool to delete a Twilio authentication configuration by its ID. Use when you need to remove a Twilio auth integration from the system.
>
> #### Input Parameters
>
> **twilio\_auth\_id** `string` *required*
>
> Unique identifier of the Twilio authentication to delete
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete UserWhatsApp By ID
>
> **Slug:** `INSIGHTO_AI_DELETE_USERWHATSAPP_BY_ID`
>
> Tool to delete a UserWhatsApp by its ID. Use when you need to remove a specific UserWhatsApp connection.
>
> #### Input Parameters
>
> **userwhatsapp\_id** `string` *required*
>
> Unique identifier of the UserWhatsApp to delete
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete Widget By ID
>
> **Slug:** `INSIGHTO_AI_DELETE_WIDGET_BY_ID`
>
> Tool to delete a widget by its unique ID. Use when you need to permanently remove a widget from the system.
>
> #### Input Parameters
>
> **widget\_id** `string` *required*
>
> Unique identifier of the widget to delete
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Agency Billing Plan
>
> **Slug:** `INSIGHTO_AI_GET_AGENCY_BILLING_PLAN`
>
> Retrieve an agency billing plan by ID to view its details, including limits for bots, queries, words and voice seconds, and its support options.
>
> #### Input Parameters
>
> **billing\_plan\_id** `string` *required*
>
> Unique identifier of the billing plan to retrieve
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Agency Branding By ID
>
> **Slug:** `INSIGHTO_AI_GET_AGENCY_BRANDING_BY_ID`
>
> Tool to retrieve branding configuration for a specific agency by agency ID. Use when you have a valid agency ID and need its branding settings.
>
> #### Input Parameters
>
> **agency\_id** `string` *required*
>
> Unique identifier of the agency whose branding to retrieve
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Agent List
>
> **Slug:** `INSIGHTO_AI_GET_AGENT_LIST`
>
> Tool to fetch a paginated list of agents. Use when you need to retrieve user/agent information with pagination support.
>
> #### Input Parameters
>
> **page** `integer`
>
> Page number, must be at least 1. Default is 1.
>
> **size** `integer`
>
> Number of agents per page, between 1 and 100. Default is 50.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Assistant By ID
>
> **Slug:** `INSIGHTO_AI_GET_ASSISTANT_BY_ID`
>
> Tool to retrieve details of a specific assistant by assistant ID. Use when you have a valid assistant ID and need the full assistant profile.
>
> #### Input Parameters
>
> **assistant\_id** `string` *required*
>
> Unique identifier of the assistant to retrieve
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Captured Form By Form ID
>
> **Slug:** `INSIGHTO_AI_GET_CAPTURED_FORM_BY_FORM_ID`
>
> Tool to retrieve captured form submissions by form ID. Use when you have a valid form ID and need to fetch all submissions for that specific form with pagination support.
>
> #### Input Parameters
>
> **page** `integer`
>
> Page number for pagination, must be at least 1. Default is 1.
>
> **size** `integer`
>
> Number of captured forms per page, between 1 and 100. Default is 50.
>
> **form\_id** `string` *required*
>
> Unique identifier of the form to retrieve captured submissions for
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Contact By ID
>
> **Slug:** `INSIGHTO_AI_GET_CONTACT_BY_ID`
>
> Tool to retrieve details of a specific contact by contact ID. Use when you have a valid contact ID and need the full contact profile.
>
> #### Input Parameters
>
> **contact\_id** `string` *required*
>
> Unique identifier of the contact to retrieve
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Datasource By ID
>
> **Slug:** `INSIGHTO_AI_GET_DATASOURCE_BY_ID`
>
> Tool to retrieve details of a specific datasource by datasource ID. Use when you have a valid datasource ID and need the full datasource details.
>
> #### Input Parameters
>
> **datasource\_id** `string` *required*
>
> Unique identifier of the datasource to retrieve
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Intent By ID
>
> **Slug:** `INSIGHTO_AI_GET_INTENT_BY_ID`
>
> Tool to retrieve details of a specific intent by its ID. Use when you have a valid intent ID and need the full intent details.
>
> #### Input Parameters
>
> **intent\_id** `string` *required*
>
> Unique identifier of the intent to retrieve
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get List Of Contacts
>
> **Slug:** `INSIGHTO_AI_GET_LIST_OF_CONTACTS`
>
> Tool to fetch a paginated list of contacts. Use after confirming a valid API key to iterate through pages of contacts.
>
> #### Input Parameters
>
> **page** `integer`
>
> Page number, must be at least 1. Default is 1.
>
> **size** `integer`
>
> Number of contacts per page, between 1 and 100. Default is 50.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get List Of Conversations
>
> **Slug:** `INSIGHTO_AI_GET_LIST_OF_CONVERSATIONS`
>
> Tool to fetch a list of conversations. Use after specifying date range and filters to retrieve conversation metadata.
>
> #### Input Parameters
>
> **page** `integer`
>
> Page number for pagination (>=1)
>
> **size** `integer`
>
> Number of items per page (1-100)
>
> **date\_to** `string` *required*
>
> End date (inclusive) in ISO 8601 format with zero time (midnight UTC). Must use T00:00:00Z time component.
>
> **date\_from** `string` *required*
>
> Start date (inclusive) in ISO 8601 format with zero time (midnight UTC). Must use T00:00:00Z time component.
>
> **intent\_id** `string`
>
> Filter by intent ID
>
> **assistant\_id** `string`
>
> Filter by assistant ID
>
> **includes\_voice** `boolean`
>
> If true, only return voice-enabled conversations
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get List Of Datasources
>
> **Slug:** `INSIGHTO_AI_GET_LIST_OF_DATASOURCES`
>
> List Insighto.ai data sources to discover available knowledge sources and their IDs. Results are paginated, with a default page size of 50 and a maximum of 100. Requires an admin or manager role.
>
> #### Input Parameters
>
> **page** `integer`
>
> Page number for pagination (starts at 1)
>
> **size** `integer`
>
> Number of items per page (1-100, default 50)
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get List Of Data Sources Linked To Assistant Id
>
> **Slug:** `INSIGHTO_AI_GET_LIST_OF_DATA_SOURCES_LINKED_TO_ASSISTANT_ID`
>
> Tool to retrieve a paginated list of data sources linked to a specific assistant. Use when you need to discover which data sources are associated with an assistant ID. Requires admin or manager role.
>
> #### Input Parameters
>
> **page** `integer`
>
> Page number for pagination, must be at least 1. Default is 1.
>
> **size** `integer`
>
> Number of data sources per page, between 1 and 100. Default is 50.
>
> **assistant\_id** `string` *required*
>
> Unique identifier (UUID) of the assistant to get data sources for
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get List Of Widgets Linked To Assistant Id
>
> **Slug:** `INSIGHTO_AI_GET_LIST_OF_WIDGETS_LINKED_TO_ASSISTANT_ID`
>
> Tool to fetch a paginated list of widgets linked to a specific assistant. Use when you need to discover which widgets are associated with an assistant ID.
>
> #### Input Parameters
>
> **page** `integer`
>
> Page number for pagination, must be at least 1. Default is 1.
>
> **size** `integer`
>
> Number of widgets per page, between 1 and 100. Default is 50.
>
> **assistant\_id** `string` *required*
>
> Unique identifier (UUID) of the assistant to get widgets for
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Pricing For User
>
> **Slug:** `INSIGHTO_AI_GET_PRICING_FOR_USER`
>
> Tool to retrieve pricing information for Insighto.ai services. Use when you need to calculate costs for LLM, voice, or transcription services.
>
> #### Input Parameters
>
> **llm\_model\_id** `string`
>
> Optional identifier of the LLM model to get pricing for.
>
> **voice\_stt\_id** `string`
>
> Optional identifier of the speech-to-text (STT) voice model to get pricing for.
>
> **voice\_tts\_id** `string`
>
> Optional identifier of the text-to-speech (TTS) voice model to get pricing for.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Prompt By ID
>
> **Slug:** `INSIGHTO_AI_GET_PROMPT_BY_ID`
>
> Tool to retrieve details of a specific prompt by prompt ID. Use when you have a valid prompt ID and need the full prompt details.
>
> #### Input Parameters
>
> **prompt\_id** `string` *required*
>
> Unique identifier of the prompt to retrieve
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Provider By ID
>
> **Slug:** `INSIGHTO_AI_GET_PROVIDER_BY_ID`
>
> Tool to retrieve details of a specific provider by provider ID. Use when you have a valid provider ID and need the full provider configuration.
>
> #### Input Parameters
>
> **provider\_id** `string` *required*
>
> Unique identifier of the provider to retrieve
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Speechtotext List
>
> **Slug:** `INSIGHTO_AI_GET_SPEECHTOTEXT_LIST`
>
> Tool to fetch a paginated list of available speech-to-text voice configurations. Use when you need to retrieve available languages and providers for voice-to-text conversion.
>
> #### Input Parameters
>
> **page** `integer`
>
> Page number for pagination, must be at least 1. Default is 1.
>
> **size** `integer`
>
> Number of items per page, between 1 and 1000. Default is 50.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Widget By ID
>
> **Slug:** `INSIGHTO_AI_GET_WIDGET_BY_ID`
>
> Tool to retrieve details of a specific widget by widget ID. Use when you have a valid widget ID and need the widget configuration.
>
> #### Input Parameters
>
> **widget\_id** `string` *required*
>
> Unique identifier of the widget to retrieve
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Channels
>
> **Slug:** `INSIGHTO_AI_LIST_CHANNELS`
>
> Tool to retrieve a paginated list of channels. Use after authenticating to fetch all available channels and their configurations.
>
> #### Input Parameters
>
> **page** `integer`
>
> Page number to fetch, must be at least 1. Default is 1.
>
> **size** `integer`
>
> Number of channels per page, must be at least 1. Default is 50.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Read Campaign Contact List
>
> **Slug:** `INSIGHTO_AI_READ_CAMPAIGN_CONTACT_LIST`
>
> Tool to retrieve a paginated list of contacts associated with a specific campaign. Use when you need to fetch all contacts enrolled in a campaign.
>
> #### Input Parameters
>
> **page** `integer`
>
> Page number to fetch, must be at least 1. Default is 1.
>
> **size** `integer`
>
> Number of contacts per page, between 1 and 100. Default is 50.
>
> **campaign\_id** `string` *required*
>
> Unique identifier of the campaign. Must be a valid UUID format.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Read Contact Custom Field List
>
> **Slug:** `INSIGHTO_AI_READ_CONTACT_CUSTOM_FIELD_LIST`
>
> Tool to retrieve a list of custom fields associated with contacts. Use when you need to inspect or sync contact metadata definitions.
>
> #### Input Parameters
>
> **page** `integer`
>
> Page number to fetch, must be at least 1. Default is 1.
>
> **size** `integer`
>
> Number of custom fields per page, between 1 and 100. Default is 50.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Read Contact Sync Log List
>
> **Slug:** `INSIGHTO_AI_READ_CONTACT_SYNC_LOG_LIST`
>
> Tool to retrieve a paginated list of contact sync logs. Use when you need to inspect sync history, troubleshoot sync issues, or audit contact synchronization operations.
>
> #### Input Parameters
>
> **page** `integer`
>
> Page number to fetch, must be at least 1. Default is 1.
>
> **size** `integer`
>
> Number of sync logs per page, between 1 and 100. Default is 50.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Read Intents List
>
> **Slug:** `INSIGHTO_AI_READ_INTENTS_LIST`
>
> Tool to retrieve a list of all intents. Use after authenticating; supports pagination.
>
> #### Input Parameters
>
> **page** `integer`
>
> Page number to retrieve (>= 1)
>
> **size** `integer`
>
> Number of intents per page (1-100)
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Read Tag List
>
> **Slug:** `INSIGHTO_AI_READ_TAG_LIST`
>
> Tool to retrieve a paginated list of tags. Use after authenticating to fetch and browse through all available tags.
>
> #### Input Parameters
>
> **page** `integer`
>
> Page number to fetch, must be at least 1. Default is 1.
>
> **size** `integer`
>
> Number of tags per page, between 1 and 100. Default is 50.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Read Tool Function Invoke Log List
>
> **Slug:** `INSIGHTO_AI_READ_TOOL_FUNCTION_INVOKE_LOG_LIST`
>
> Tool to retrieve a paginated list of tool function invoke logs. Use when you need to inspect function invocation history, troubleshoot tool execution issues, or audit tool function calls.
>
> #### Input Parameters
>
> **page** `integer`
>
> Page number to fetch, must be at least 1. Default is 1.
>
> **size** `integer`
>
> Number of logs per page, between 1 and 100. Default is 50.
>
> **conversation\_id** `string`
>
> Filter logs by conversation ID (UUID). If provided, only returns logs for the specified conversation.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Read Tool Toolfunction List
>
> **Slug:** `INSIGHTO_AI_READ_TOOL_TOOLFUNCTION_LIST`
>
> Tool to retrieve a paginated list of tool functions for a specific tool. Use after authenticating to fetch and browse through all tool functions associated with a given tool ID.
>
> #### Input Parameters
>
> **page** `integer`
>
> Page number to fetch, must be at least 1. Default is 1.
>
> **size** `integer`
>
> Number of tool functions per page, between 1 and 100. Default is 50.
>
> **tool\_id** `string` *required*
>
> Unique identifier of the tool to fetch functions for
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Read Twilio Auth List
>
> **Slug:** `INSIGHTO_AI_READ_TWILIO_AUTH_LIST`
>
> Tool to retrieve a paginated list of Twilio authentications. Use after authenticating to fetch and browse through all configured Twilio auth integrations.
>
> #### Input Parameters
>
> **page** `integer`
>
> Page number to fetch, must be at least 1. Default is 1.
>
> **size** `integer`
>
> Number of Twilio authentications per page, between 1 and 100. Default is 50.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Retrieve Linked Tool And User
>
> **Slug:** `INSIGHTO_AI_RETRIEVE_LINKED_TOOL_AND_USER`
>
> Tool to retrieve linked tool and user information for a specific tool. Use when you need to fetch users linked to a tool by tool ID.
>
> #### Input Parameters
>
> **page** `integer`
>
> Page number to retrieve, must be at least 1. Default is 1.
>
> **size** `integer`
>
> Number of items per page, between 1 and 100. Default is 50.
>
> **tool\_id** `string` *required*
>
> Unique identifier of the tool (UUID format)
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Retrieve List Of User Custom Voice
>
> **Slug:** `INSIGHTO_AI_RETRIEVE_LIST_OF_USER_CUSTOM_VOICE`
>
> Tool to retrieve a paginated list of user custom voices. Use after authenticating to fetch available custom voices.
>
> #### Input Parameters
>
> **page** `integer`
>
> Page number to retrieve, must be at least 1. Default is 1.
>
> **size** `integer`
>
> Number of voices per page, between 1 and 1000. Default is 50.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Retrieve User Monthly Usages Aggregation
>
> **Slug:** `INSIGHTO_AI_RETRIEVE_USER_MONTHLY_USAGES_AGGREGATION`
>
> Tool to retrieve user monthly usages aggregation data. Use when you need to fetch analytics about user usage patterns aggregated by month.
>
> #### Input Parameters
>
> **page** `integer`
>
> Page number for pagination, must be at least 1. Default is 1.
>
> **size** `integer`
>
> Number of records per page, between 1 and 100. Default is 50.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Retrieve Webhook Log
>
> **Slug:** `INSIGHTO_AI_RETRIEVE_WEBHOOK_LOG`
>
> Tool to retrieve webhook logs for a specific webhook. Use to monitor webhook delivery status and debug webhook issues.
>
> #### Input Parameters
>
> **page** `integer`
>
> Page number to fetch, must be at least 1. Default is 1.
>
> **size** `integer`
>
> Number of webhook logs per page, between 1 and 100. Default is 50.
>
> **webhook\_id** `string` *required*
>
> Unique identifier of the webhook to retrieve logs for.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Send Messages To Contacts
>
> **Slug:** `INSIGHTO_AI_SEND_MESSAGES_TO_CONTACTS`
>
> Tool to send messages to a list of contacts in bulk. Use when your widget is connected to WhatsApp or SMS and you have the contact IDs ready.
>
> #### Input Parameters
>
> **message** `string`
>
> Text message to send (only for chat-based assistants; ignored for calling).
>
> **widget\_id** `string` *required*
>
> Widget ID connected to WhatsApp or SMS.
>
> **contact\_ids** `array` *required*
>
> List of UUIDs identifying contacts to receive messages.
>
> **start\_new\_conversation** `boolean`
>
> Start a new conversation thread instead of replying to the existing one.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update Link Tool User
>
> **Slug:** `INSIGHTO_AI_UPDATE_LINK_TOOL_USER`
>
> Tool to update a link tool user by its ID. Use when you need to modify properties of an existing tool integration.
>
> #### Input Parameters
>
> **name** `string`
>
> Name of the link tool user
>
> **org\_id** `string`
>
> Organization ID associated with the link tool user
>
> **tool\_id** `string`
>
> Tool ID associated with the link tool user
>
> **attributes** `object`
>
> Custom attributes for the link tool user
>
> **credentials** `object`
>
> Credentials object for the tool integration
>
> **link\_tool\_user\_id** `string` *required*
>
> Unique identifier of the link tool user to update
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update Tool By ID
>
> **Slug:** `INSIGHTO_AI_UPDATE_TOOL_BY_ID`
>
> Tool to update a tool by its ID. Use when you need to modify properties of an existing tool such as name, description, or enabled status.
>
> #### Input Parameters
>
> **sdk** `object`
>
> SDK configuration for the tool as a dictionary
>
> **name** `string`
>
> Name of the tool
>
> **org\_id** `string`
>
> Organization ID associated with the tool
>
> **enabled** `boolean`
>
> Whether the tool is enabled
>
> **tool\_id** `string` *required*
>
> Unique identifier of the tool to update
>
> **base\_url** `string`
>
> Base URL for the tool's API endpoint
>
> **category** `string`
>
> Category of the tool (IToolCategoryEnum)
>
> **logo\_url** `string`
>
> URL to the tool's logo
>
> **tool\_type** `string`
>
> Type of the tool (IToolTypeEnum)
>
> **attributes** `object`
>
> Custom attributes for the tool as a dictionary
>
> **description** `string`
>
> Description of the tool
>
> **tool\_provider** `string`
>
> Tool provider identifier (IChannelProviderEnum)
>
> **authentication** `object`
>
> Authentication configuration for the tool as a dictionary
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update Toolfunction By ID
>
> **Slug:** `INSIGHTO_AI_UPDATE_TOOLFUNCTION_BY_ID`
>
> Tool to update an existing toolfunction by its ID. Use when you need to modify properties of a toolfunction such as name, description, type, or enabled status.
>
> #### Input Parameters
>
> **name** `string`
>
> Name of the toolfunction.
>
> **details** `object`
>
> Additional custom details or configuration for the toolfunction.
>
> **tool\_id** `string`
>
> Tool ID to associate with this toolfunction.
>
> **is\_enabled** `boolean`
>
> Whether the toolfunction is enabled or disabled.
>
> **description** `string`
>
> Description of the toolfunction and its purpose.
>
> **toolfunction\_id** `string` *required*
>
> Unique identifier of the toolfunction to update.
>
> **tool\_function\_type** `string ("sdk" | "curl" | "query_index")`
>
> Enum for tool function types based on API documentation.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update Twilio Auth By ID
>
> **Slug:** `INSIGHTO_AI_UPDATE_TWILIO_AUTH_BY_ID`
>
> Tool to update a Twilio authentication configuration by its ID. Use when you need to modify Twilio auth credentials or settings.
>
> #### Input Parameters
>
> **name** `string`
>
> Display name for the Twilio authentication
>
> **twilio\_auth\_id** `string` *required*
>
> Unique identifier of the Twilio authentication to update
>
> **twilio\_auth\_token** `string`
>
> Twilio authentication token
>
> **twilio\_account\_sid** `string`
>
> Twilio account SID for authentication
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update User Profile
>
> **Slug:** `INSIGHTO_AI_UPDATE_USER_PROFILE`
>
> Tool to update a user profile in Insighto.ai. Use when modifying user account details, contact information, or billing settings.
>
> #### Input Parameters
>
> **city** `string`
>
> User's city
>
> **email** `string`
>
> User's email address
>
> **phone** `string`
>
> User's phone number in E.164 format
>
> **state** `string`
>
> User's state or province
>
> **address** `string`
>
> User's physical address
>
> **country** `string`
>
> User's country
>
> **role\_id** `string`
>
> Role identifier for the user
>
> **user\_id** `string` *required*
>
> Unique identifier of the user to update
>
> **is\_trial** `boolean`
>
> Whether the user is on a trial subscription
>
> **birthdate** `string`
>
> User's birthdate in ISO 8601 format
>
> **is\_active** `boolean`
>
> Whether the user account is active
>
> **is\_paying** `boolean`
>
> Whether the user has a paid subscription
>
> **last\_name** `string`
>
> User's last name
>
> **first\_name** `string`
>
> User's first name
>
> **used\_trial** `boolean`
>
> Whether the user has previously used a trial
>
> **is\_superuser** `boolean`
>
> Whether the user has superuser privileges
>
> **is\_enterprise** `boolean`
>
> Whether the user is an enterprise customer
>
> **billing\_updated\_at** `string`
>
> Timestamp when billing information was last updated
>
> **stripe\_customer\_id** `string`
>
> Stripe customer identifier
>
> **last\_credits\_refresh** `string`
>
> Timestamp of the last credits refresh
>
> **next\_billing\_plan\_id** `string`
>
> Identifier of the billing plan scheduled for next billing cycle
>
> **next\_credits\_refresh** `string`
>
> Timestamp of the next scheduled credits refresh
>
> **active\_billing\_plan\_id** `string`
>
> Identifier of the user's current active billing plan
>
> **stripe\_subscription\_id** `string`
>
> Stripe subscription identifier
>
> **stripe\_last\_payment\_date** `string`
>
> Date of the last payment processed via Stripe
>
> **stripe\_has\_payment\_method** `boolean`
>
> Whether the user has a payment method on file in Stripe
>
> **stripe\_subscription\_status** `string`
>
> Current status of the Stripe subscription
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update UserWhatsApp By ID
>
> **Slug:** `INSIGHTO_AI_UPDATE_USERWHATSAPP_BY_ID`
>
> Tool to update a UserWhatsApp configuration by its ID. Use when you need to modify WhatsApp Business API settings for a user.
>
> #### Input Parameters
>
> **phone\_number\_id** `string`
>
> Phone number ID associated with WhatsApp Business API
>
> **userwhatsapp\_id** `string` *required*
>
> Unique identifier of the UserWhatsApp to update
>
> **phone\_business\_id** `string`
>
> Phone business ID associated with WhatsApp Business API
>
> **facebook\_app\_secret** `string`
>
> Facebook app secret for WhatsApp Business API integration
>
> **whatsapp\_access\_token** `string`
>
> WhatsApp access token for authentication
>
> **whatsapp\_phone\_number** `string`
>
> WhatsApp phone number to update
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update Webhook By ID
>
> **Slug:** `INSIGHTO_AI_UPDATE_WEBHOOK_BY_ID`
>
> Tool to update an outbound webhook by its unique ID. Use when you need to modify webhook configuration such as name, endpoint URL, or enabled status.
>
> #### Input Parameters
>
> **name** `string`
>
> New name for the webhook
>
> **enabled** `boolean`
>
> Whether the webhook should be enabled or disabled
>
> **endpoint** `string`
>
> New URL endpoint where webhook events will be sent. Must be a valid HTTP/HTTPS URL.
>
> **webhook\_id** `string` *required*
>
> Unique identifier of the webhook to update
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Upsert Contact By Email Or Phone Number
>
> **Slug:** `INSIGHTO_AI_UPSERT_CONTACT_BY_EMAIL_OR_PHONE_NUMBER`
>
> Create or update an Insighto.ai contact using its email address and phone number. Both identifiers and the contact's first and last names are required.
>
> #### Input Parameters
>
> **email** `string` *required*
>
> Email address of the contact. Used as a unique identifier for upserting.
>
> **last\_name** `string` *required*
>
> Last name of the contact.
>
> **first\_name** `string` *required*
>
> First name of the contact.
>
> **phone\_number** `string` *required*
>
> Phone number of the contact including the country code. For example: 16501111234 (no spaces or special characters).
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not
