--- canonical_url: "https://docs.composio.dev/toolkits/fuseai" markdown_url: "https://docs.composio.dev/toolkits/fuseai.md" product: "platform" version: null last_updated: null --- # FuseAI FuseAI is an AI-powered sales platform for prospecting, enrichment, campaigns, signal agents, research, and revenue analytics. - **Category:** ai sales tools - **Auth:** API_KEY - **Composio-managed OAuth available?** N/A - **Tools:** 141 - **Triggers:** 0 - **Slug:** `FUSEAI` - **Version:** 00000000_00 ## Tools ### Activate Agent **Slug:** `FUSEAI_ACTIVATE_AGENT` Activate a draft FuseAI signal agent and begin monitoring. WARNING: this irreversible operation creates the results list, starts provider work, and deducts workspace credits; a paused or previously started agent cannot be resumed with this endpoint. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `agent_id` | string | Yes | ID of the draft agent to activate. WARNING: activation is irreversible, begins monitoring, and deducts FuseAI credits. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Add List Members **Slug:** `FUSEAI_ADD_LIST_MEMBERS` Add up to 5,000 existing contacts to a Fuse prospect list by contact ID. Contacts already in the list are skipped, making repeated calls idempotent. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `list_id` | string | Yes | 24-character hexadecimal ID of the prospect list to update. | | `contact_ids` | array | Yes | IDs of 1-5000 existing contacts to add. Use row IDs returned by a prospect-list rows request or IDs returned when resolving contacts. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Approve Campaign **Slug:** `FUSEAI_APPROVE_CAMPAIGN` Approve a draft or stopped FuseAI campaign and start its sending scheduler. WARNING: this may immediately begin externally visible email or LinkedIn outreach; messages already sent cannot be recalled. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `campaign_id` | string | Yes | ID of the draft or stopped campaign to activate. WARNING: approval starts the scheduler and may send externally visible messages that cannot be recalled. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Approve Scheduled Sends **Slug:** `FUSEAI_APPROVE_SCHEDULED_SENDS` Approve selected FuseAI queued sends that are waiting for review. WARNING: each approved row becomes scheduled and its externally visible message may be sent at the scheduled time; sent messages cannot be recalled. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `send_ids` | array | Yes | WARNING: 1-100 unique queued-send IDs to approve. Approval moves each eligible send from approval_required to scheduled, allowing its externally visible message to be sent at the scheduled time; sent messages cannot be recalled. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Autocomplete Agent Field **Slug:** `FUSEAI_AUTOCOMPLETE_AGENT_FIELD` Resolve free text to canonical region, industry, title, or school values accepted by Fuse agent configuration filters. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `field` | string ("region" | "industry" | "title" | "school") | Yes | Vocabulary to search: region, industry, title, or school. Region values feed regions and authorLocation; industry values feed industries; title values feed currentTitle, pastTitle, and authorTitle. Region is not a country vocabulary for companyCountries or leadCompanyCountries. | | `query` | string | Yes | Free-text term to resolve (1-200 characters). The endpoint returns up to 10 canonical values, best match first. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Autocomplete Company Search Field **Slug:** `FUSEAI_AUTOCOMPLETE_COMPANY_SEARCH_FIELD` Suggest canonical company names, domains, investor domains, or fully qualified headquarters city values for Fuse company-search filters. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `field` | string ("company" | "location") | Yes | Company-search field to complete. Use company for company names and domains, or location for fully qualified headquarters city names. | | `query` | string | Yes | Text fragment to complete (2-200 characters). | | `org_type` | string | No | Set to investor to restrict company suggestions to investors. Only valid when field is company. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Autocomplete Prospect Search Field **Slug:** `FUSEAI_AUTOCOMPLETE_PROSPECT_SEARCH_FIELD` Suggest canonical values for a free-text prospect-search field without consuming search credits. Region suggestions also identify their countries. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `field` | string ("company" | "website" | "location" | "region" | "title" | "school" | "skill") | Yes | Free-text prospect-search field whose stored values to suggest: company, website, location, region, title, school, or skill. | | `query` | string | Yes | Text fragment to complete (1-100 characters). | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Cancel Research Run **Slug:** `FUSEAI_CANCEL_RESEARCH_RUN` WARNING: Request asynchronous cancellation of an in-flight FuseAI research run, then poll Get Research Run until it reports cancelled. Provider actions already completed are not refunded; only reserved credits are released. Completed, failed, or already-cancelled runs cannot be cancelled. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `run_id` | string | Yes | ID of the in-flight research run to cancel, from the runId returned when the research run was started. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Commit Import **Slug:** `FUSEAI_COMMIT_IMPORT` Commit a parsed spreadsheet import into an existing contact list or a destination list created or reused by name. Provide exactly one of list_id or list_name. This creates persistent contacts asynchronously; optional enrichment consumes non-refundable credits. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `enrich` | string ("none" | "email" | "phone" | "phone_and_email" | "demographics") | No | Optional enrichment mode. Omit or use none to save uploaded rows as-is; other modes consume credits for processed contacts. | | `list_id` | string | No | 24-character hex ID of an existing destination contact list. Provide exactly one of list_id or list_name. | | `mapping` | object | No | Up to 200 source-column headers mapped to Fuse field labels. Use null for an unmapped header; the suggested mapping from import creation can be passed unchanged. | | `import_id` | string | Yes | ID returned when the spreadsheet import was created or presigned. | | `list_name` | string | No | Destination contact-list name to create or reuse. Provide exactly one of list_name or list_id. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Copy Prospect List Rows **Slug:** `FUSEAI_COPY_PROSPECT_LIST_ROWS` Copy up to 10,000 filtered rows from one contact list into an existing or create-or-reused destination contact list. Provide exactly one of list_id or list_name. The operation starts asynchronously; poll the returned destination list until completionStatus is complete. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `limit` | integer | Yes | Maximum rows to copy (1-10000). | | `filters` | object | No | Optional source-row filters. Values within one key are OR-joined; different keys are AND-joined. | | `list_id` | string | No | 24-character hex ID of an existing destination contact list. Provide exactly one of list_id or list_name. | | `list_name` | string | No | Destination contact-list name to create or reuse. Provide exactly one of list_name or list_id. | | `source_list_id` | string | Yes | 24-character hex ID of the contact list whose rows are copied. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Create Campaign **Slug:** `FUSEAI_CREATE_CAMPAIGN` Create a FuseAI draft campaign from one or more prospect lists. This call does not send messages; approval is a separate operation. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `list_id` | string | No | ID of the single non-archived Fuse contact list to use as the campaign source. Provide exactly one of list_id or list_ids. | | `channels` | array | No | Ordered channel scaffold (1-10 steps): email, linkedin_connection, linkedin_message, or inmail. Omit for Fuse's default [email]. At most one linkedin_connection is allowed, and it must precede every linkedin_message. Do not provide channels with template_id. | | `cta_link` | string | No | Absolute HTTP(S) call-to-action URL used by CTA-link variables in steps. Omit, pass null, or pass an empty string for no link. | | `list_ids` | array | No | One to ten non-archived Fuse contact-list IDs to combine in order as a deduplicated campaign source. Provide exactly one of list_id or list_ids. | | `timezone` | string | No | IANA time zone for the 09:00-17:00 sending window and email_days, such as America/New_York, Europe/Berlin, Asia/Kolkata, or UTC. | | `delegates` | array | No | Fuse user IDs of teammates allowed to view, edit, and activate the campaign in the app. Obtain IDs from GET /business/team/members and only provide trusted teammates: Fuse does not verify team membership when this campaign is created. | | `email_days` | array | No | One to seven distinct weekdays on which sends may occur. Omit for Monday through Friday. A due send moves to the next selected weekday. | | `is_dynamic` | boolean | No | Whether contacts added to the source lists after activation should be enrolled automatically by Fuse's background refresh. | | `template_id` | string | No | Saved campaign-template ID whose steps and channels Fuse should copy. Do not provide channels when using a template. | | `user_prompt` | string | No | For ai-generated campaigns only, a brief of up to 5000 characters describing the offer and campaign goal. | | `website_urls` | array | No | For ai-generated campaigns only, up to ten absolute HTTP(S) URLs whose page content should ground the generated copy. | | `campaign_name` | string | Yes | Display name of the campaign (1-200 characters); Fuse also uses it as the stem of campaign CSV export filenames. | | `campaign_type` | string ("ai-generated" | "manual") | No | manual creates editable empty steps immediately; ai-generated starts background prompt analysis and topic generation that must complete before the campaign is edited or approved. | | `exclude_lists` | array | No | Up to ten contact-list IDs whose members are excluded from enrollment. A source list repeated here is ignored; omit for no contact-list exclusions. | | `additional_info` | string | No | For ai-generated campaigns only, up to 10000 characters of product details, positioning, or proof points to ground generated copy. | | `knowledge_hub_id` | string | No | For ai-generated campaigns only, a non-archived knowledge-hub ID. Omit to use the default hub. | | `writing_style_id` | string | No | For ai-generated campaigns only, a Fuse writing-style ID. Omit or pass null to use the default writing style. | | `exclude_contacted` | string ("none" | "ever" | "last_1_month" | "last_3_months" | "last_6_months" | "last_1_year") | No | Prior-contact exclusion window: none, ever, last_1_month, last_3_months, last_6_months, or last_1_year. Pending sends in active campaigns are always excluded. | | `use_linkedin_posts` | boolean | No | Whether Fuse should fetch each contact's recent LinkedIn posts at activation for AI personalization. Contacts need a LinkedIn URL. | | `campaign_start_date` | string | No | ISO 8601 date-time before which nothing is sent. Omit to start from the current time; Fuse evaluates it in timezone and against email_days. | | `add_unsubscribe_link` | boolean | No | Whether every email step should include a one-click unsubscribe footer. | | `exclude_company_lists` | array | No | Up to twenty team-owned contact- or company-list IDs whose companies' contacts are excluded. Unknown, archived, or foreign lists are rejected. | | `exclude_engaged_contacts` | boolean | No | Whether to exclude contacts who already replied to one of your campaigns. | | `open_rate_tracking_enabled_at` | string | No | ISO 8601 timestamp recording when the email open-tracking pixel was enabled. Omit or pass null to keep open tracking off. | | `send_only_to_validated_emails_enabled_at` | string | No | ISO 8601 timestamp from which enrollment accepts only contacts with a validated email. Omit or pass null to allow catch-all and unverified uploaded addresses. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Create Campaign Step **Slug:** `FUSEAI_CREATE_CAMPAIGN_STEP` Add one email, LinkedIn, InMail, dialer, or task step at an unused position in a FuseAI campaign sequence. This creates the draft step but does not approve or activate the campaign. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `cc` | array | No | Up to 10 bare email addresses copied on every email sent by this step. Fuse stores but does not use them for non-email channels. | | `body` | string | No | Message body for a manual step, up to 20000 characters. Variable tokens and spintax are substituted when Fuse sends the message. For a linkedin_connection step this is the invitation note, which must be 200 characters or fewer. Do not provide content for linkedin_visit or linkedin_like. | | `type` | string ("manual" | "ai_generated" | "ai_reply") | No | How content is produced: manual uses the supplied subject and body; ai_generated creates its own topic and title; ai_reply drafts a reply from the required topic and waits for approval. | | `topic` | string | No | Free-text brief for the step (1-500 characters). Required for ai_reply, rejected for ai_generated, linkedin_visit, and linkedin_like, and stored without rendering for manual steps. | | `channel` | string ("email" | "linkedin_connection" | "linkedin_message" | "linkedin_visit" | "linkedin_like" | "inmail" | "dialer" | "todo") | Yes | Delivery channel. linkedin_connection must precede every linkedin_message step in the campaign; linkedin_visit and linkedin_like carry no message content. | | `subject` | string | No | Subject for a manual step, up to 500 characters. Do not provide it for linkedin_visit or linkedin_like. | | `campaign_id` | string | Yes | ID of the campaign that will receive the step. Use the 24-character hexadecimal campaignId returned by a create, get, or list campaign call. | | `days_between` | integer | Yes | Whole days to wait after the previous step, or after campaign start for the first step (0-90). | | `sequence_number` | integer | Yes | Unused 0-based position for the step (0-50). Existing steps are not shifted when a step is inserted. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Create Campaign Template **Slug:** `FUSEAI_CREATE_CAMPAIGN_TEMPLATE` Save an owned FuseAI campaign's current steps and schedule settings as a reusable template. Later campaign edits do not update this snapshot. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `name` | string | Yes | Name of the new campaign template (1-200 characters, trimmed). | | `campaign_id` | string | Yes | ID of the owned campaign whose steps and schedule settings should be snapshotted into the template. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Create Companies Watcher Agent **Slug:** `FUSEAI_CREATE_COMPANIES_WATCHER_AGENT` Create a FuseAI agent that watches companies from one or more existing lists for job postings, LinkedIn posts, press mentions, or funding milestones. This saves an unbilled draft; use Activate Agent to begin monitoring. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `list_id` | string | No | ID of one existing source list whose companies the agent watches. Provide exactly one of list_id or list_ids. | | `keywords` | array | No | Distinct, non-empty job-title keywords. Required for company-watch-linkedin-job-postings and ignored for other event types. | | `list_ids` | array | No | IDs of existing source lists whose companies the agent watches. Their members are unioned and duplicate company IDs are collapsed. Provide exactly one of list_id or list_ids. | | `frequency` | integer | No | Number of days between checks and billing cycles (1-90). | | `list_name` | string | Yes | Unique name for both the agent and its new dedicated results list. Do not reuse a source list's name. | | `event_type` | string ("company-watch-linkedin-job-postings" | "company-watch-linkedin-posts" | "company-watch-press-mentions" | "company-watch-funding-milestones") | Yes | Change to monitor for companies in the source list or lists. | | `max_contacts` | integer | No | Maximum total results delivered into the agent's list. Omit for no cap. | | `expiration_date` | string | No | Future stop date in YYYY-MM-DD format. Omit for one month after creation; pass null to run until the agent is paused or deleted. | | `max_credit_spend` | integer | No | Maximum credits the agent may spend in one run or refresh (1000-200000). Omit for no credit limit. | | `job_posting_location_types` | array | No | Job work arrangements to match for a LinkedIn job-postings watcher. Values are OR-joined; omit to match any arrangement. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Create Company Department Headcount Agent **Slug:** `FUSEAI_CREATE_COMPANY_DEPARTMENT_HEADCOUNT_AGENT` Create a FuseAI agent that finds companies whose selected department has a specified employee count. This saves an unbilled draft; use Activate Agent to begin monitoring. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `regions` | array | Yes | Exactly one headquarters geography from FuseAI's agent autocomplete endpoint, such as United States or California, United States. An unsupported value can create an agent that matches nothing. | | `list_name` | string | Yes | Unique name for both the agent and its results list. FuseAI rejects a name already used by another list or agent. | | `industries` | array | Yes | Exactly one LinkedIn industry from FuseAI's agent autocomplete endpoint. An unresolved value may be dropped and silently widen the agent's filter. | | `max_contacts` | integer | No | Maximum total results delivered into the agent's list. Omit for no cap. | | `annual_revenue` | object | No | Optional company annual-revenue range in millions of USD. Both min and max are required when this filter is supplied. | | `expiration_date` | string | No | Future stop date in YYYY-MM-DD format. Omit for one month after creation; pass null to run until the agent is paused or deleted. | | `max_credit_spend` | integer | No | Maximum credits the agent may spend in one run or refresh (1000-200000). Omit for no credit limit. | | `company_headcount` | array | No | Optional whole-company size bucket. Supply at most one of: 1-10, 11-50, 51-200, 201-500, 501-1,000, 1,001-5,000, 5,001-10,000, or 10,001+. | | `notification_count` | integer | No | Maximum results delivered in one run; a positive multiple of 50. | | `department_headcount` | object | Yes | Department and absolute employee-count range to monitor. Both bounds and the department are required. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Create Company Headcount Growth Agent **Slug:** `FUSEAI_CREATE_COMPANY_HEADCOUNT_GROWTH_AGENT` Create a FuseAI agent that finds companies within a specified year-over-year headcount growth range. This saves an unbilled draft; use Activate Agent to begin monitoring. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `regions` | array | Yes | Exactly one headquarters geography from the FuseAI agent autocomplete endpoint, such as United States or California, United States. Unsupported values can create an agent that matches nothing. | | `list_name` | string | Yes | Unique name for both the agent and its results list. FuseAI rejects a name already used by another list or agent. | | `industries` | array | Yes | Exactly one LinkedIn industry from the FuseAI agent autocomplete endpoint. An unsupported value may be dropped and silently widen the agent's filter. | | `max_contacts` | integer | No | Maximum total results delivered into the agent's list. Omit for no cap. | | `annual_revenue` | object | No | Optional company annual-revenue range in millions of USD. Both min and max are required when this filter is supplied. | | `expiration_date` | string | No | Future stop date in YYYY-MM-DD format. Omit for one month after creation; pass null to run until the agent is paused or deleted. | | `max_credit_spend` | integer | No | Maximum credits the agent may spend in one run or refresh (1000-200000). Omit for no credit limit. | | `company_countries` | array | No | Deprecated and ignored by FuseAI on this route. Use regions instead; this value is accepted for compatibility but is not sent. | | `company_headcount` | array | Yes | Exactly one company-size bucket: 1-10, 11-50, 51-200, 201-500, 501-1,000, 1,001-5,000, 5,001-10,000, or 10,001+. Use the exact punctuation shown. | | `notification_count` | integer | No | Maximum results delivered in one run; must be a positive multiple of 50. | | `company_headcount_growth` | object | Yes | Year-over-year company headcount growth range in percent. For example, min 10 and max 50 matches companies that grew 10% to 50%. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Create First Department Hire Agent **Slug:** `FUSEAI_CREATE_FIRST_DEPARTMENT_HIRE_AGENT` Create a FuseAI agent that finds companies making their first hire in a specified department. This saves an unbilled draft; use Activate Agent to begin monitoring. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `regions` | array | Yes | Exactly one headquarters geography from the FuseAI agent autocomplete endpoint, such as United States or California, United States. Unsupported values can create an agent that matches nothing. | | `list_name` | string | Yes | Unique name for both the agent and its results list. FuseAI rejects a name already used by another list or agent. | | `industries` | array | Yes | Exactly one LinkedIn industry from the FuseAI agent autocomplete endpoint. An unsupported value may be dropped and silently widen the agent's filter. | | `max_contacts` | integer | No | Maximum total results delivered into the agent's list. Omit for no cap. | | `annual_revenue` | object | No | Optional company annual-revenue range in millions of USD. Both min and max are required when this filter is supplied. | | `expiration_date` | string | No | Future stop date in YYYY-MM-DD format. Omit for one month after creation; pass null to run until the agent is paused or deleted. | | `max_credit_spend` | integer | No | Maximum credits the agent may spend in one run or refresh (1000-200000). Omit for no credit limit. | | `num_of_followers` | array | No | Deprecated and ignored by FuseAI on this route. Use company_headcount instead; this value is accepted for compatibility but is not sent. | | `company_headcount` | array | Yes | Exactly one company-size bucket: 1-10, 11-50, 51-200, 201-500, 501-1,000, 1,001-5,000, 5,001-10,000, or 10,001+. Use the exact punctuation shown. | | `company_department` | array | Yes | Exactly one department to monitor, using FuseAI's documented department name, such as Sales, Engineering, or Human Resources. | | `notification_count` | integer | No | Maximum results delivered in a single run. Must be a positive multiple of 50. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Create First International Hire Agent **Slug:** `FUSEAI_CREATE_FIRST_INTERNATIONAL_HIRE_AGENT` Create a FuseAI agent that finds companies making their first hire outside their home country. This saves an unbilled draft; use Activate Agent to begin monitoring. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `regions` | array | Yes | Exactly one company-headquarters geography from the FuseAI agent autocomplete operation, such as United States or California, United States. Unsupported values can create an agent that matches nothing. | | `list_name` | string | Yes | Unique name for both the agent and its results list. FuseAI rejects a name already used by another list or agent. | | `industries` | array | Yes | Exactly one LinkedIn industry from the FuseAI agent autocomplete operation. An unsupported value may be dropped and silently widen the agent's filter. | | `max_contacts` | integer | No | Maximum total results delivered into the agent's list. Omit for no cap. | | `annual_revenue` | object | No | Optional company annual-revenue range in millions of USD. Both min and max are required when this filter is supplied. | | `expiration_date` | string | No | Future stop date in YYYY-MM-DD format. Omit for one month after creation; pass null to run until the agent is paused or deleted. | | `max_credit_spend` | integer | No | Maximum credits the agent may spend in one run or refresh (1000-200000). Omit for no credit limit. | | `company_headcount` | array | Yes | Exactly one company-size bucket: 1-10, 11-50, 51-200, 201-500, 501-1,000, 1,001-5,000, 5,001-10,000, or 10,001+. Use the exact punctuation shown; unsupported values can silently match nothing. | | `notification_count` | integer | No | Maximum results delivered in one run, as a positive multiple of 50. | | `company_headcount_growth` | object | No | Deprecated and ignored by FuseAI for this agent type. Use company_headcount instead; this value is accepted for compatibility but is not sent. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Create Folder **Slug:** `FUSEAI_CREATE_FOLDER` Create a folder for contact lists, company lists, campaigns, or agents. Folder names must be unique within the selected kind. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `name` | string | Yes | Folder name (1-120 characters). The name must be unique among folders of the selected kind. | | `type` | string ("contactList" | "companyList" | "campaign" | "agent") | No | Folder kind: contactList or companyList for lists, campaign for campaigns, or agent for agents. Defaults to contactList. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Create Funding Announcements Agent **Slug:** `FUSEAI_CREATE_FUNDING_ANNOUNCEMENTS_AGENT` Create a FuseAI agent that monitors funding announcements by round type and company filters. This saves an unbilled draft; use Activate Agent to begin monitoring. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `list_name` | string | Yes | Unique name for both the agent and its results list. FuseAI rejects a name already used by another list or agent. | | `industries` | array | No | LinkedIn industries to match, using exact values from the FuseAI agent autocomplete endpoint. Multiple industries are OR-joined. At least one company filter is required. | | `max_contacts` | integer | No | Maximum total results delivered into the agent's list. Omit for no cap. | | `expiration_date` | string | No | Future stop date in YYYY-MM-DD format. Omit for one month after creation; pass null to run until the agent is paused or deleted. | | `max_credit_spend` | integer | No | Maximum credits the agent may spend in one run or refresh (1000-200000). Omit for no credit limit. | | `company_countries` | array | No | Headquarters countries to match as full English names, not ISO codes. Multiple countries are OR-joined. At least one company filter is required. | | `company_headcount` | array | No | Company-size buckets to match. Multiple buckets are OR-joined. Use the exact punctuation shown by the schema. At least one company filter is required. | | `notification_count` | integer | No | Maximum results delivered in one run; a positive multiple of 50. | | `funding_round_types` | array | Yes | Funding round types to monitor. Multiple values are OR-joined; pass an empty list to monitor every funding round type. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Create Headcount Growth Over Baseline Agent **Slug:** `FUSEAI_CREATE_HEADCOUNT_GROWTH_OVER_BASELINE_AGENT` Create a FuseAI agent that finds companies whose headcount grew by a specified percentage over a historical baseline. This saves an unbilled draft; use Activate Agent to begin monitoring. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `regions` | array | Yes | Exactly one company-headquarters geography. Use an exact LinkedIn geography returned by the agent autocomplete operation; unsupported text is accepted but may silently match nothing. | | `list_name` | string | Yes | Unique name for both the agent and its results list. FuseAI rejects a name already used by another list or agent. | | `timeframe` | array | Yes | Exactly one interval over which growth is measured: YoY, MoM, QoQ, 6M, or 2Y. Common long forms such as year over year and 12 months are also accepted. | | `industries` | array | Yes | Exactly one company industry. Use an exact value returned by the agent autocomplete operation; unmatched values may be dropped and silently widen the filter. | | `max_contacts` | integer | No | Maximum total results delivered into the agent's list. Omit for no cap. | | `annual_revenue` | object | No | Optional company annual-revenue range in millions of USD. Both min and max are required when this filter is supplied. | | `expiration_date` | string | No | Future stop date in YYYY-MM-DD format. Omit for one month after creation; pass null to run until the agent is paused or deleted. | | `max_credit_spend` | integer | No | Maximum credits the agent may spend in one run or refresh (1000-200000). Omit for no credit limit. | | `baseline_headcount` | array | Yes | Exactly one historical employee count from which growth is measured, such as 75 or 1000. This is an absolute count, not a percentage. | | `notification_count` | integer | No | Maximum results delivered per run; must be a positive multiple of 50. | | `company_headcount_growth_from_baseline` | array | Yes | Exactly one percentage growth threshold over baseline_headcount. For example, 25 requires headcount to be 25 percent above the baseline. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Create Job Changes Watcher Agent **Slug:** `FUSEAI_CREATE_JOB_CHANGES_WATCHER_AGENT` Create a FuseAI agent that watches people in one or more existing lists for company or title changes. This saves an unbilled draft; use Activate Agent to begin monitoring. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `list_id` | string | No | ID of one existing source list whose trackable contacts the agent watches. Provide exactly one of list_id or list_ids. | | `list_ids` | array | No | IDs of existing source lists whose trackable contacts the agent watches. IDs must be unique. Provide exactly one of list_ids or list_id. | | `list_name` | string | Yes | Unique name for both the agent and its new results list. Do not reuse a source list name or another agent name. | | `enrich_email` | boolean | No | Whether to enrich each delivered contact with a work email address. This costs additional credits. | | `enrich_phone` | boolean | No | Whether to enrich each delivered contact with a phone number. This costs additional credits. | | `max_contacts` | integer | No | Maximum total results the agent may deliver into its results list. Omit for no contact limit. | | `max_credit_spend` | integer | No | Maximum credits the agent may spend in one run or refresh (1000-200000). Omit for no credit limit. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Create Job Keyword Match Agent **Slug:** `FUSEAI_CREATE_JOB_KEYWORD_MATCH_AGENT` Create a FuseAI agent that finds companies posting jobs matching title or description terms in one region. This saves an unbilled draft; use Activate Agent to begin monitoring. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `titles` | array | No | Job-title keywords to OR together, such as Software Engineer and Backend Developer. Provide titles, descriptions, or both. | | `regions` | array | Yes | Exactly one LinkedIn job-posting geography, such as a country or sub-national area. Use an exact region returned by the agent autocomplete operation; unsupported text is accepted but silently matches nothing. | | `list_name` | string | Yes | Unique name for both the agent and its results list. FuseAI rejects a name already used by another list or agent. | | `industries` | array | No | Hiring-company industries to OR together. Prefer exact values returned by the agent autocomplete operation; unmatched values may be dropped, silently widening the search. | | `descriptions` | array | No | At most one keyword or phrase that must appear in the job description. Provide titles, descriptions, or both. | | `max_contacts` | integer | No | Maximum total results the agent may deliver into its list. Omit for no contact limit. | | `expiration_date` | string | No | Future stop date in YYYY-MM-DD format. Omit for one month after creation; pass null to run until the agent is paused or deleted. | | `max_credit_spend` | integer | No | Maximum credits the agent may spend in one run or refresh (1000-200000). Omit for no credit limit. | | `company_countries` | array | No | Full English headquarters country names to OR together, such as United States or Germany. ISO country codes are not supported. | | `company_headcount` | array | No | Hiring-company size buckets to OR together. Values must use the exact documented spelling, including commas. | | `notification_count` | integer | No | Maximum results delivered per run; must be a positive multiple of 50. | | `exact_keyword_match` | boolean | No | Whether title and description keywords require exact matching. False allows semantic matches. | | `exact_industry_match` | boolean | No | Whether industry values require exact matching. False allows semantic industry matches. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Create Knowledge Hub **Slug:** `FUSEAI_CREATE_KNOWLEDGE_HUB` Create a FuseAI knowledge hub from one or more websites and optional text notes. The asynchronous crawl starts immediately; use the returned hub ID to check whether processing completes. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `name` | string | No | Hub name (1-100 characters). Omit to have FuseAI generate a name after the crawl completes. | | `notes` | array | No | Up to fifty free-text sources. Add file attachments after the hub is complete rather than including them here. | | `websites` | array | Yes | One to twenty websites whose crawled content is pooled into one knowledge hub. Crawl failures appear later as a null last_crawled_at; read the hub after creation to check them. | | `is_default` | boolean | No | Whether this becomes the default campaign knowledge hub, unsetting the previous default. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Create Knowledge Hub Page **Slug:** `FUSEAI_CREATE_KNOWLEDGE_HUB_PAGE` Add a user-authored Markdown page to a completed FuseAI knowledge hub. FuseAI indexes the page before returning, and later hub rebuilds preserve it. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `title` | string | Yes | Page title (1-200 characters). | | `hub_id` | string | Yes | 24-character hexadecimal ID of the knowledge hub that will receive the page, from the list knowledge hubs action. | | `content` | string | Yes | Page body in Markdown (1-60,000 characters). FuseAI indexes it into the hub's knowledge store before returning. | | `category` | string ("overview" | "products" | "pricing" | "icp-use-cases" | "differentiators" | "competitors" | "faq" | "source-digest" | "custom") | No | Page category used to group it with generated pages. Use overview for a company summary, products, pricing, icp-use-cases, differentiators, competitors, faq, source-digest, or custom for user-authored material. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Create Large Import Upload Target **Slug:** `FUSEAI_CREATE_LARGE_IMPORT_UPLOAD_TARGET` Create a short-lived external PUT target for a CSV, XLS, or XLSX import file over 10 MiB and up to 50 MiB. This action only returns upload instructions: it does not upload bytes, parse the file, preview it, or commit contacts. After the caller performs the external PUT, use Preview Import with import_id. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `filename` | string | Yes | Original file name for the import (1-500 characters). The file format is determined by content_type rather than the file extension. | | `content_type` | string ("text/csv" | "application/vnd.ms-excel" | "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet") | Yes | MIME type of the CSV, XLS, or XLSX file. Use this same Content-Type when PUTting the raw bytes to the returned external URL. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Create LinkedIn Post Engagement Agent **Slug:** `FUSEAI_CREATE_LINKEDIN_POST_ENGAGEMENT_AGENT` Create a FuseAI agent that collects people who liked or commented on up to 50 specific LinkedIn posts. This saves an unbilled draft; use Activate Agent to begin scraping. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `post_url` | string | No | One LinkedIn post URL containing /feed/update/, /posts/, or /pulse/. Provide exactly one of post_url or post_urls. | | `list_name` | string | Yes | Unique name for both the agent and its results list. FuseAI rejects a name already used by another list or agent. | | `post_urls` | array | No | One to 50 unique LinkedIn post URLs containing /feed/update/, /posts/, or /pulse/. Provide exactly one of post_url or post_urls. | | `enrich_email` | boolean | No | Whether to enrich every delivered contact with a work email address. This costs additional credits. | | `enrich_phone` | boolean | No | Whether to enrich every delivered contact with a phone number. This costs additional credits. | | `enable_recurring` | boolean | No | Whether to repeat the scrape every seven days instead of running it only once. | | `fields_to_scrape` | array | Yes | Engagement to collect: likes for reactors, comments for commenters, or both. Values must be unique. | | `max_credit_spend` | integer | No | Maximum credits the agent may spend in one run or refresh (1000-200000). Omit for no credit limit. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Create LinkedIn Profile Agent **Slug:** `FUSEAI_CREATE_LINKEDIN_PROFILE_AGENT` Create a FuseAI agent that collects reactors or commenters from recent posts by up to 50 LinkedIn profiles. The draft can configure a one-time scrape or, with enable_recurring, recurring scrapes that optionally stop at recurring_expires_at. Creation is unbilled and does not start scraping; use Activate Agent to start the configured operation. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `list_name` | string | Yes | Unique name for both the agent and its results list. FuseAI rejects a name already used by another list or agent. | | `max_posts` | integer | No | Number of each profile's most recent posts to inspect (1-100). | | `profile_url` | string | No | One full LinkedIn profile URL. Provide exactly one of profile_url or profile_urls. | | `enrich_email` | boolean | No | Whether to enrich each delivered contact with a work email. This costs additional credits. | | `enrich_phone` | boolean | No | Whether to enrich each delivered contact with a phone number. This costs additional credits. | | `posted_limit` | string ("24h" | "week" | "month" | "3months" | "year") | No | Age window for posts whose engagement is collected. | | `profile_urls` | array | No | One to 50 unique full LinkedIn profile URLs. Provide exactly one of profile_url or profile_urls. | | `include_reposts` | boolean | No | Whether to include the profile's reposts and quote posts. | | `enable_recurring` | boolean | No | Whether to repeat the scrape instead of running it once. | | `fields_to_scrape` | array | Yes | Engagement to collect: likes for reactors, comments for commenters, or both. Entries must be unique. | | `max_credit_spend` | integer | No | Maximum credits the agent may spend in one run or refresh (1000-200000). Omit for no credit limit. | | `recurring_expires_at` | string | No | Future ISO 8601 date-time when a recurring scrape stops. Omit to keep it running until manually stopped. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Create LinkedIn Topic Discovery Agent **Slug:** `FUSEAI_CREATE_LINKEDIN_TOPIC_DISCOVERY_AGENT` Create a FuseAI agent that finds authors, and optionally reactors, of LinkedIn posts matching specified topics and filters. This saves an unbilled draft; use Activate Agent to begin monitoring. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `keywords` | array | Yes | Post-text searches to OR together. Each entry may use uppercase AND, OR, NOT, parentheses, and double quotes for exact phrases. | | `reactors` | boolean | No | Whether to also deliver people who reacted to matching posts. Delivered reactors cost additional credits. | | `list_name` | string | Yes | Unique name for both the agent and its results list. Fuse rejects a name already used by another list or agent. | | `actor_type` | array | No | Post-author kinds to include: person, company, or both. Omit to include both. | | `industries` | array | No | At most one posting-person or posting-company industry. Use an exact value from the agents autocomplete endpoint with field=industry. | | `past_title` | array | No | Past author job titles to OR together. Use exact values from the agents autocomplete endpoint with field=title. | | `post_intent` | array | No | At most one plain-language intent describing the post content, not the person or company posting it. | | `author_title` | array | No | Current author job titles to OR together. Use exact values from the agents autocomplete endpoint with field=title. | | `enrich_email` | boolean | No | Whether to enrich each delivered contact with a work email. This costs additional credits. | | `enrich_phone` | boolean | No | Whether to enrich each delivered contact with a phone number. This costs additional credits. | | `max_contacts` | integer | No | Maximum total results the agent may deliver. Omit for no contact limit. | | `past_company` | array | No | Past employers of the author as company names or domains. Values are OR-joined; domains are the least ambiguous form. | | `current_title` | array | No | Deprecated current-title filter. Use author_title. It is read only when author_title is omitted. | | `post_category` | array | No | Up to ten provider-classified post categories to OR together, such as Business, Personal, Events, or Social Commentary. | | `author_company` | array | No | LinkedIn company URLs for the author's current employers. Values are OR-joined; bare names and domains do not resolve. | | `author_location` | array | No | At most one author region. Use an exact value from the agents autocomplete endpoint with field=region. | | `current_company` | array | No | Deprecated author-company filter. Use author_company. When author_company is omitted, provide LinkedIn company URLs rather than names or domains. | | `expiration_date` | string | No | Future stop date in YYYY-MM-DD format. Omit for one month after creation; pass null to run until the agent is paused or deleted. | | `max_credit_spend` | integer | No | Maximum credits the agent may spend in one run or refresh (1000-200000). Omit for no credit limit. | | `company_countries` | array | No | Posting-company headquarters countries as full English names, not ISO codes. Values are OR-joined. Provide this or company_headcount when start is true. | | `company_headcount` | array | No | Posting-company size buckets. Values are OR-joined. Provide this or company_countries when start is true. | | `notification_count` | integer | No | Maximum results delivered in one run; must be a positive multiple of 50. | | `detailed_reactor_data` | boolean | No | Whether to enrich delivered reactors with employer, education, and summary data. This is meaningful only when reactors is true and costs more credits. | | `lead_company_countries` | array | No | Headquarters countries of the author's current employer as full English names, OR-joined. | | `lead_company_headcount` | array | No | Size buckets for the author's current employer, OR-joined. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Create List Column **Slug:** `FUSEAI_CREATE_LIST_COLUMN` Create a plain custom column on a Fuse prospect list. Use the returned column ID to write cell values; use a smart column instead for AI-computed values. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `name` | string | Yes | Name for the custom column (1-100 characters). Names must be unique within the list, compared case-insensitively. | | `type` | string ("string" | "number" | "date" | "boolean" | "url") | No | Value type stored by the column: string, number, date, boolean, or url. URL cells contain a label and value. | | `list_id` | string | Yes | 24-character hexadecimal ID of the prospect list. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Create People Watcher Agent **Slug:** `FUSEAI_CREATE_PEOPLE_WATCHER_AGENT` Create a FuseAI agent that watches people from one or more existing contact lists for LinkedIn profile or post updates. This saves an unbilled draft; use Activate Agent to begin monitoring. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `list_id` | string | No | ID of one existing contact list whose people to watch. Provide exactly one of list_id or list_ids. | | `list_ids` | array | No | IDs of existing contact lists whose people to watch. Their members are unioned and duplicate IDs are collapsed. Provide exactly one of list_ids or list_id. | | `frequency` | integer | No | Monitoring and billing interval in days (1-90). | | `list_name` | string | Yes | Unique name for both the agent and its new results list. Do not reuse a source list's name. | | `event_type` | string ("linkedin-person-profile-updates" | "linkedin-person-post-updates") | Yes | Change to monitor for people in the source lists: LinkedIn profile updates or LinkedIn post updates. | | `enrich_email` | boolean | No | Whether to enrich every delivered contact with a work email address, which costs additional credits. | | `enrich_phone` | boolean | No | Whether to enrich every delivered contact with a phone number, which costs additional credits. | | `max_contacts` | integer | No | Maximum total results delivered into the agent's list. Omit for no cap. | | `expiration_date` | string | No | Future stop date in YYYY-MM-DD format. Omit for one month after creation; pass null to run until the agent is paused or deleted. | | `max_credit_spend` | integer | No | Maximum credits the agent may spend in one run or refresh (1000-200000). Omit for no credit limit. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Create Person Discovery Via Filters Agent **Slug:** `FUSEAI_CREATE_PERSON_DISCOVERY_VIA_FILTERS_AGENT` Create a FuseAI agent that discovers people matching explicit filters. At least one filter must be non-empty. This saves an unbilled draft; use Activate Agent to begin discovery. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `regions` | array | No | LinkedIn geographies where people are located. Use exact region values from the agents autocomplete operation; values are OR-joined. | | `list_name` | string | Yes | Unique name for both the agent and its results list. FuseAI rejects a name already used by another list or agent. | | `industries` | array | No | Industries people work in. Use exact values from the agents autocomplete operation; values are OR-joined. | | `past_title` | array | No | Past job titles. Use exact values from the agents autocomplete operation; values are OR-joined. | | `enrich_email` | boolean | No | Whether to enrich each delivered contact with a work email address, which costs additional credits. | | `enrich_phone` | boolean | No | Whether to enrich each delivered contact with a phone number, which costs additional credits. | | `max_contacts` | integer | No | Maximum total results the agent may deliver. Omit for no contact limit. | | `past_company` | array | No | Past employers as company names or domains. Domains are unambiguous; values are OR-joined. | | `current_title` | array | No | Current job titles. Use exact values from the agents autocomplete operation; values are OR-joined. | | `current_company` | array | No | Current employers as company names or domains. Domains are unambiguous; values are OR-joined. | | `expiration_date` | string | No | Future stop date in YYYY-MM-DD format. Omit for one month after creation; pass null to run until the agent is paused or deleted. | | `max_credit_spend` | integer | No | Maximum credits the agent may spend in one run or refresh (1000-200000). Omit for no credit limit. | | `company_countries` | array | No | Current-employer headquarters countries as full English names, not ISO codes; values are OR-joined. | | `company_headcount` | array | No | Current-employer headcount buckets. Use exact FuseAI values such as 1-10, 11-50, 501-1,000, or 10,001+; values are OR-joined. | | `notification_count` | integer | No | Maximum results delivered per run; must be a positive multiple of 50. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Create Person Starting New Job Agent **Slug:** `FUSEAI_CREATE_PERSON_STARTING_NEW_JOB_AGENT` Create a FuseAI agent that watches one industry for people starting new jobs. This saves an unbilled draft; use Activate Agent to begin monitoring. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `reactors` | boolean | No | Whether to also deliver people who reacted to matching posts. Reactor delivery costs additional credits. | | `list_name` | string | Yes | Unique name for both the agent and its results list. FuseAI rejects a name already used by another list or agent. | | `industries` | array | Yes | Exactly one industry in which to watch for job changes. Use an exact value from the agent autocomplete endpoint; an unresolved value may be silently dropped and widen the search. | | `past_title` | array | No | Past job titles. Use exact values from the agent autocomplete endpoint; multiple values are OR-joined. | | `author_title` | array | No | Job titles people are starting in. Use exact values from the agent autocomplete endpoint; multiple titles are OR-joined. Prefer this over current_title. | | `enrich_email` | boolean | No | Whether to enrich each delivered contact with a work email address. This costs additional credits. | | `enrich_phone` | boolean | No | Whether to enrich each delivered contact with a phone number. This costs additional credits. | | `max_contacts` | integer | No | Maximum total results the agent may deliver into its list. Omit for no contact limit. | | `past_company` | array | No | Past employers as company names or domains. Domains are least ambiguous; multiple values are OR-joined. | | `current_title` | array | No | Deprecated fallback for author_title. Use exact title values from the agent autocomplete endpoint; multiple values are OR-joined. | | `author_company` | array | No | Companies people are joining, as company LinkedIn URLs. Multiple URLs are OR-joined. Prefer this over current_company. | | `current_company` | array | No | Deprecated fallback for author_company. When author_company is omitted, provide company LinkedIn URLs; multiple values are OR-joined. | | `expiration_date` | string | No | Future stop date in YYYY-MM-DD format. Omit for one month after creation; pass null to run until the agent is paused or deleted. | | `max_credit_spend` | integer | No | Maximum credits the agent may spend in one run or refresh (1000-200000). Omit for no credit limit. | | `notification_count` | integer | No | Maximum results delivered in one run. Must be a positive multiple of 50. | | `detailed_reactor_data` | boolean | No | Whether to enrich delivered reactors with employer, education, and summary data. Meaningful only when reactors is true and costs more. | | `lead_company_countries` | array | No | Current-employer headquarters countries as full English country names, not ISO codes. Multiple countries are OR-joined. | | `lead_company_headcount` | array | No | Current-employer headcount buckets. Use exact FuseAI bucket labels such as 1-10, 501-1,000, or 10,001+; multiple buckets are OR-joined. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Create Prospect List **Slug:** `FUSEAI_CREATE_PROSPECT_LIST` Create an empty contact or company prospect list owned by the connected FuseAI user. The name must be unique within the workspace. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `name` | string | Yes | Unique name for the new prospect list (1-255 characters). Leading and trailing whitespace is removed. | | `entity_type` | string ("contactList" | "companyList") | No | Kind of list to create: contactList for people or companyList for companies. Defaults to contactList. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Create Regional Job Discovery Agent **Slug:** `FUSEAI_CREATE_REGIONAL_JOB_DISCOVERY_AGENT` Create a FuseAI agent that finds companies posting jobs in one region, optionally filtered by industry, company size, and headquarters country. This saves an unbilled draft; use Activate Agent to begin monitoring. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `regions` | array | Yes | Exactly one LinkedIn geography where jobs are posted, such as United States or California, United States. Use an exact value returned by the agent autocomplete operation for region; unsupported text can silently produce no matches. | | `list_name` | string | Yes | Unique name for both the agent and its results list. FuseAI rejects a name already used by another list or agent. | | `industries` | array | No | Hiring-company industries, OR-joined. Use exact values returned by the agent autocomplete operation for industry; unmatched values may be dropped and silently widen the search. | | `max_contacts` | integer | No | Maximum total results the agent may deliver. Omit for no contact limit. | | `expiration_date` | string | No | Future stop date in YYYY-MM-DD format. Omit for one month after creation; pass null to run until the agent is paused or deleted. | | `max_credit_spend` | integer | No | Maximum credits the agent may spend in one run or refresh (1000-200000). Omit for no credit limit. | | `company_countries` | array | No | Hiring-company headquarters countries, OR-joined, as full English country names such as United States or Germany. Do not use ISO codes; unsupported names can silently produce no matches. | | `company_headcount` | array | No | Hiring-company size buckets, OR-joined. Valid values are 1-10, 11-50, 51-200, 201-500, 501-1,000, 1,001-5,000, 5,001-10,000, and 10,001+. | | `notification_count` | integer | No | Maximum results delivered in one run, as a positive multiple of 50. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Create Saved Search **Slug:** `FUSEAI_CREATE_SAVED_SEARCH` Store a reusable people or company search under a display name. The returned filters can be sent to the matching search operation, and the selected search type is immutable. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `type` | string ("people" | "company") | No | Search kind: people (default) or company. This determines the filter vocabulary and cannot be changed after creation. | | `title` | string | Yes | Display name for the saved search (1-255 characters). Titles need not be unique, but duplicate titles cannot be used as saved-search-name selectors later. | | `filters` | string | No | Optional non-empty filters in the selected type's search vocabulary. For people searches, use fields and values from the prospect filter-options operation; first_name and last_name cannot be saved. For company searches, use fields and values from the company filter-options operation. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Create Smart Column **Slug:** `FUSEAI_CREATE_SMART_COLUMN` Create an AI-powered column on a FuseAI prospect list and start its first asynchronous, credit-consuming research run over the selected rows. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `name` | string | Yes | Unique display name for the smart column (1-100 characters). Reserved built-in names such as name, email, and phone are not allowed. | | `engine` | string ("standard" | "deep_research") | No | Research engine. standard is faster; deep_research uses multiple providers at a higher per-row credit cost. | | `prompt` | string | Yes | Research instruction to answer for each covered row. Fuse stores the answer in the row's cell and retains its sources as provenance. | | `run_on` | string ("first_1" | "first_10" | "first_100" | "first_1000" | "all") | Yes | Rows to research in the first billed run: first_1, first_10, first_100, first_1000, or all, evaluated after filters. | | `filters` | object | No | Optional Fuse row-filter object. Use canonical built-in field keys and put custom or smart column filters under customColumns keyed by column ID. | | `list_id` | string | Yes | 24-character hexadecimal ID of the prospect list to update. | | `provider_ids` | array | No | For deep_research only, 1-50 distinct provider IDs from the research providers endpoint. Omit to use every provider available to the workspace. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Create Two Country Workforce Agent **Slug:** `FUSEAI_CREATE_TWO_COUNTRY_WORKFORCE_AGENT` Create an unbilled draft of FuseAI's provider-defined signal agent for companies with an employee distribution across two countries. FuseAI does not specify or let the caller choose the country pair; regions filters the company's headquarters, not employee locations. Use Activate Agent to begin monitoring. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `regions` | array | Yes | Exactly one company-headquarters LinkedIn geography, such as United States or California, United States. Use an exact value returned by the agent autocomplete operation; unsupported text may match nothing. | | `list_name` | string | Yes | Unique name for both the agent and its results list. FuseAI rejects a name already used by another list or agent. | | `industries` | array | Yes | Exactly one company industry. Use an exact value returned by the agent autocomplete operation; an unresolved value may be dropped and silently widen the filter. | | `max_contacts` | integer | No | Maximum total results delivered into the agent's list. Omit for no cap. | | `annual_revenue` | object | No | Optional company annual-revenue range in millions of USD. Both min and max are required when this filter is supplied. | | `expiration_date` | string | No | Future stop date in YYYY-MM-DD format. Omit for one month after creation; pass null to run until the agent is paused or deleted. | | `max_credit_spend` | integer | No | Maximum credits the agent may spend in one run or refresh (1000-200000). Omit for no credit limit. | | `company_headcount` | array | Yes | Exactly one company-size bucket. Use one of 1-10, 11-50, 51-200, 201-500, 501-1,000, 1,001-5,000, 5,001-10,000, or 10,001+. | | `notification_count` | integer | No | Maximum results delivered per run; must be a positive multiple of 50. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Create Web Monitor Agent **Slug:** `FUSEAI_CREATE_WEB_MONITOR_AGENT` Create a FuseAI agent that repeatedly searches the web for matching people or companies. This saves an unbilled draft; use Activate Agent to begin monitoring. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `prompt` | string | Yes | Natural-language description of the signal to find on the open web (1-2000 characters). Include a year when recency matters. | | `list_name` | string | Yes | Unique name for both the agent and its results list. FuseAI rejects a name already used by another list or agent. | | `entity_type` | string ("person" | "company") | Yes | Type of result to find: person or company. | | `num_results` | integer | No | Number of web pages to read per run (1-100), not the number of matches. Omit for 10. | | `max_contacts` | integer | No | Maximum total results the agent may deliver into its list. Omit for no contact limit. | | `search_period` | string ("1h" | "6h" | "1d" | "7d") | No | How often to rerun the search: 1h, 6h, 1d, or 7d. Omit for 1d. | | `expiration_date` | string | No | Future stop date in YYYY-MM-DD format. Omit for one month after creation; pass null to run until the agent is paused or deleted. | | `max_credit_spend` | integer | No | Maximum credits the agent may spend in one run or refresh (1000-200000). Omit for no credit limit. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Decline Scheduled Sends **Slug:** `FUSEAI_DECLINE_SCHEDULED_SENDS` Permanently stop selected queued FuseAI sends. Eligible sends move from approval_required or scheduled to stopped, and each affected contact's remaining campaign sequence is halted rather than advanced. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `send_ids` | array | Yes | Unique IDs of 1-100 queued sends to stop. Sends in approval_required or scheduled state are eligible; stopping one also ends that contact's remaining sequence in the campaign. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Delete Agent **Slug:** `FUSEAI_DELETE_AGENT` Permanently delete a FuseAI agent and tear down its provider subscriptions. The agent's results list and previously delivered rows are retained. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `agent_id` | string | Yes | 24-character hexadecimal ID of the agent to delete, from the list agents action or an agent creation response. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Delete Campaign **Slug:** `FUSEAI_DELETE_CAMPAIGN` Stop and delete a campaign. Sending halts immediately and the campaign disappears from campaign reads, while delivered sends and contact state remain. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `campaign_id` | string | Yes | 24-character hex ID of the campaign to stop and delete. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Delete Campaign Step **Slug:** `FUSEAI_DELETE_CAMPAIGN_STEP` Permanently remove one sequence step from a FuseAI campaign. Remaining steps are renumbered, but queued sends already created for the removed step are not deleted. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `step_id` | string | Yes | 24-character hexadecimal ID of the sequence step to delete. | | `campaign_id` | string | Yes | 24-character hexadecimal ID of the campaign containing the sequence step. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Delete Campaign Template **Slug:** `FUSEAI_DELETE_CAMPAIGN_TEMPLATE` Permanently delete a saved FuseAI campaign template. Campaigns already created from the template are unaffected because they keep independent copies of its steps. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `campaign_template_id` | string | Yes | 24-character hexadecimal ID of the campaign template to delete, from the list campaign templates action. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Delete Folder **Slug:** `FUSEAI_DELETE_FOLDER` Permanently delete a folder without deleting the lists, campaigns, or agents it contained. The contained resources move back to the root. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `type` | string ("contactList" | "companyList" | "campaign" | "agent") | No | Folder kind. Pass campaign or agent for those folder kinds; omit this field for contact-list or company-list folders, which resolve by ID. | | `folder_id` | string | Yes | 24-character hexadecimal ID of the folder to delete, from the list folders action. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Delete Knowledge Hub **Slug:** `FUSEAI_DELETE_KNOWLEDGE_HUB` Soft-delete a FuseAI knowledge hub so it no longer appears in reads or grounds campaigns. The default hub cannot be deleted; make another hub the default first. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `hub_id` | string | Yes | 24-character hexadecimal ID of the knowledge hub to delete, from the list knowledge hubs action. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Delete Knowledge Hub Attachment **Slug:** `FUSEAI_DELETE_KNOWLEDGE_HUB_ATTACHMENT` Delete a document attached to a FuseAI knowledge-hub note. This removes the entire note, including its text, not only the document. To preserve the text, save it first and re-add the note after deleting the attachment. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `hub_id` | string | Yes | 24-character hexadecimal ID of the knowledge hub containing the note, from the list knowledge hubs action. | | `note_id` | string | Yes | 24-character hexadecimal ID from notes[].id in the get knowledge hub response. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Delete Knowledge Hub Page **Slug:** `FUSEAI_DELETE_KNOWLEDGE_HUB_PAGE` Permanently remove a page from a FuseAI knowledge hub and its knowledge store. Generated pages can reappear after a hub update or refresh if their sources still exist; user-authored pages cannot be recovered. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `hub_id` | string | Yes | 24-character hexadecimal ID of the knowledge hub containing the page, from the list knowledge hubs action. | | `page_id` | string | Yes | 24-character hexadecimal ID of the page to delete, from the list knowledge hub pages action. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Delete Learned Fact **Slug:** `FUSEAI_DELETE_LEARNED_FACT` Retire a learned fact so it stops contributing to the team's knowledge hubs after the next daily learning run. The fact's audit trail is retained. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `fact_id` | string | Yes | 24-character hexadecimal ID of the learned fact to retire, from the list learned facts action. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Delete List Column **Slug:** `FUSEAI_DELETE_LIST_COLUMN` Permanently delete a custom or smart column from a prospect list, including all values stored in that column. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `list_id` | string | Yes | 24-character hex ID of the list containing the column. | | `column_id` | string | Yes | 24-character hex ID of the custom or smart column to delete. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Delete Prospect List **Slug:** `FUSEAI_DELETE_PROSPECT_LIST` Delete a prospect list and its custom columns. Contacts remain in the workspace and in every other list they belong to. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `list_id` | string | Yes | 24-character hex ID of the prospect list to delete. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Delete Saved Search **Slug:** `FUSEAI_DELETE_SAVED_SEARCH` Permanently delete a saved people or company search. Lists, campaigns, and contacts created from the search are unaffected. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `saved_search_id` | string | Yes | 24-character hexadecimal ID of the saved search to delete, from the list saved searches action. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Derive Company List **Slug:** `FUSEAI_DERIVE_COMPANY_LIST` Create a company list from the companies represented by a contact list. The operation starts asynchronously; poll the returned list ID until its completionStatus is complete. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `name` | string | Yes | Unique name for the new company list (1-255 characters). | | `list_id` | string | Yes | 24-character hex ID of the contact list to derive companies from. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Duplicate Agent **Slug:** `FUSEAI_DUPLICATE_AGENT` Copy an owned FuseAI agent of any status into a new, unbilled draft. Inspect isReconstructed and lossyFields before activating a copy of an older agent. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `agent_id` | string | Yes | 24-character hexadecimal ID of the owned agent to copy, returned when an agent is created, duplicated, or listed. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Duplicate Campaign **Slug:** `FUSEAI_DUPLICATE_CAMPAIGN` Copy an owned FuseAI campaign into a fresh draft with the same sequence steps, schedule settings, and source lists. The copy has no enrolled contacts, analytics, or queued sends and sends nothing until approved. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `campaign_id` | string | Yes | 24-character hexadecimal ID of the owned campaign to copy, returned when a campaign is created or listed. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Enrich List **Slug:** `FUSEAI_ENRICH_LIST` Start an asynchronous, credit-consuming enrichment of a Fuse contact list. Discover emails or phones, revalidate existing emails, or resolve uploaded contact demographics; poll the list rows or metrics for completion. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `mode` | string ("email" | "phone" | "phone_and_email" | "validate_emails" | "demographics") | Yes | Enrichment to run: email, phone, phone_and_email, validate_emails, or demographics. Every mode consumes Fuse credits when work is performed. | | `limit` | integer | No | Maximum contacts to process and bill (1-10000). Required unless contact_ids is provided; validate_emails and demographics allow at most 5000. | | `filters` | object | No | Optional row filters for email, phone, or phone_and_email mode. Values within a key are OR-joined and different keys are AND-joined. Mutually exclusive with contact_ids. | | `list_id` | string | Yes | 24-character hexadecimal ID of the contact list to enrich. | | `contact_ids` | array | No | IDs of 1-500 rows from this list to enrich directly. Only valid for email, phone, or phone_and_email mode and mutually exclusive with filters. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Export Campaign Leads **Slug:** `FUSEAI_EXPORT_CAMPAIGN_LEADS` Export every enrolled lead in an owned FuseAI campaign as an inline CSV document. This operation does not support filtering or pagination. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `campaign_id` | string | Yes | 24-character hexadecimal ID of the owned campaign whose enrolled leads should be exported. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Export List **Slug:** `FUSEAI_EXPORT_LIST` Start an asynchronous CSV export of an entire FuseAI prospect list. Returns a job ID for polling; this operation does not consume credits. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `list_id` | string | Yes | 24-character hex ID of the prospect list to export as CSV. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Generate Campaign Step Preview **Slug:** `FUSEAI_GENERATE_CAMPAIGN_STEP_PREVIEW` Render one campaign step for a sample contact, resolving variables and spintax without saving content or sending a message. Previewing an AI-authored step can invoke FuseAI generation and consume provider compute or resources even though this action does not mutate campaign state. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `step_id` | string | Yes | ID of the sequence step to preview. Use a 24-character hexadecimal step ID returned by the list campaign steps call. | | `campaign_id` | string | Yes | ID of the campaign that owns the step. Use a 24-character hexadecimal campaign ID returned by a create, get, or list campaign call. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Get Agent **Slug:** `FUSEAI_GET_AGENT` Return one signal agent's stored configuration, lifecycle status, and source-list metadata. This does not return results delivered by the agent. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `agent_id` | string | Yes | 24-character hexadecimal agent ID returned by an agent creation, duplication, or list operation. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Get Agent Analytics **Slug:** `FUSEAI_GET_AGENT_ANALYTICS` Return team signal-agent performance for a rolling 7-, 30-, or 90-day window, including totals, type and status breakdowns, and prospects over time. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `range` | string ("7d" | "30d" | "90d") | No | Rolling analytics window ending now: 7d, 30d, or 90d. The default is 30d; Fuse selects daily or weekly time-series buckets from the window. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Get Campaign **Slug:** `FUSEAI_GET_CAMPAIGN` Return one campaign's lifecycle and initialization state. Use this to poll an AI-generated campaign until initialization completes before adding steps or approving it. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `campaign_id` | string | Yes | 24-character hexadecimal campaign ID returned when the campaign was created or listed. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Get Campaign Analytics **Slug:** `FUSEAI_GET_CAMPAIGN_ANALYTICS` Return account-wide email and LinkedIn campaign totals and time series over a rolling 7-, 30-, or 90-day window, plus top LinkedIn campaigns. Use the campaign stats action instead for one campaign's detailed metrics. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `range` | string ("7d" | "30d" | "90d") | No | Rolling analytics window ending now: 7d, 30d, or 90d. The default is 30d; Fuse returns daily buckets for 7d and weekly ISO-week buckets for 30d and 90d. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Get Campaign Stats **Slug:** `FUSEAI_GET_CAMPAIGN_STATS` Return one campaign's email send, open, click, and reply totals, plus percentage changes for the current UTC calendar month versus the previous month. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `since` | string | No | ISO 8601 date-time from which total counters are accumulated. Omit to use Fuse's default of 12 months ago. Monthly percentage deltas always compare the current UTC calendar month with the previous month. | | `campaign_id` | string | Yes | 24-character hexadecimal campaign ID returned when the campaign was created or listed. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Get Company Filter Options **Slug:** `FUSEAI_GET_COMPANY_FILTER_OPTIONS` Return the complete accepted vocabularies for enum-backed company-search filters, including industries, tags, NAICS codes, countries, and accelerators. #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Get Credit Balance **Slug:** `FUSEAI_GET_CREDIT_BALANCE` Return the connected user's available credit balance for checking whether billable Fuse operations can run. #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Get Credit Usage **Slug:** `FUSEAI_GET_CREDIT_USAGE` Return the workspace credit-spend ledger for a date range and optional team members. This action reads data even though Fuse exposes it through POST. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `to` | string | No | Inclusive end of the spend window as an ISO 8601 date or date-time; omit to use the current time. A date-only value means midnight UTC at the start of that day. | | `since` | string | Yes | Inclusive start of the spend window as an ISO 8601 date or date-time. The usage headline still covers the current billing period. | | `member_ids` | array | No | Active team-member IDs whose deductions to include in the spend series. Omit or pass an empty list for the whole workspace ledger. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Get Current User **Slug:** `FUSEAI_GET_CURRENT_USER` Return the connected user's ID, email address, and display name. This can also verify that the connected Fuse API key is valid. #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Get Dialer Analytics **Slug:** `FUSEAI_GET_DIALER_ANALYTICS` Return campaign and team power-dialer call totals and time series for a rolling 7-, 30-, or 90-day window. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `range` | string ("7d" | "30d" | "90d") | No | Rolling analytics window ending now. Use 7d for daily buckets or 30d or 90d for weekly buckets. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Get Enrichment Analytics **Slug:** `FUSEAI_GET_ENRICHMENT_ANALYTICS` Return enrichment totals and zero-filled time series for enriched emails, enriched phones, saved contacts, and searched prospects over a rolling window. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `range` | string ("7d" | "30d" | "90d") | No | Rolling analytics window ending now. Use 7d for daily buckets or 30d and 90d for ISO-week buckets. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Get Job **Slug:** `FUSEAI_GET_JOB` Poll a Fuse asynchronous job, including a list export job returned by EXPORT_LIST, and return its status, operation type, row count, failure reason, or short-lived download URL. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `job_id` | string | Yes | 24-character hexadecimal ID of the asynchronous job, including a list export job returned by EXPORT_LIST. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Get Knowledge Hub **Slug:** `FUSEAI_GET_KNOWLEDGE_HUB` Return one knowledge hub's full detail, including websites, notes, build status, and default status. Poll this action while the hub is processing. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `hub_id` | string | Yes | 24-character hexadecimal knowledge-hub ID returned when the hub was created or listed. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Get Knowledge Hub Attachment **Slug:** `FUSEAI_GET_KNOWLEDGE_HUB_ATTACHMENT` Return a knowledge-hub note attachment's filename, MIME type, byte size, and presigned download URL. The URL remains valid for one hour. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `hub_id` | string | Yes | 24-character hexadecimal knowledge-hub ID returned when the hub was created or listed. | | `note_id` | string | Yes | 24-character hexadecimal note ID from the hub's notes list. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Get Prospect Filter Options **Slug:** `FUSEAI_GET_PROSPECT_FILTER_OPTIONS` Return the complete accepted prospect-search vocabulary, each field's required value shape, and the role-to-sub-role mapping. Use each vocabulary entry's value, not its label, when constructing a prospect search. #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Get Prospect List **Slug:** `FUSEAI_GET_PROSPECT_LIST` Return one prospect list's metadata, processing status, row count, enrichment metrics, and optionally its column definitions. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `include` | string | No | Set to 'columns' to include the list's custom and smart column definitions. | | `list_id` | string | Yes | 24-character hexadecimal ID of the prospect list. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Get Prospect List Filter Values **Slug:** `FUSEAI_GET_PROSPECT_LIST_FILTER_VALUES` Return the distinct company names or web domains stored in a prospect list for use in row filters and exclusion sets. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `field` | string ("name" | "domain") | Yes | Company field whose distinct values to return: name for company names or domain for company web domains. Contact lists return an empty array. | | `list_id` | string | Yes | 24-character hexadecimal ID of the prospect list. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Get Research Run **Slug:** `FUSEAI_GET_RESEARCH_RUN` Return one research run's current state, credit usage, markdown report, and resulting prospect list. Poll until status is completed, failed, or cancelled. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `run_id` | string | Yes | 24-character hexadecimal research run ID returned when the run was started. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Get Saved Search **Slug:** `FUSEAI_GET_SAVED_SEARCH` Return one saved people or company search by ID, including filters that can be sent to the matching search operation. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `saved_search_id` | string | Yes | ID of the saved search (a 24-character hexadecimal ObjectId), as returned by the list-saved-searches operation. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Get Smart Column **Slug:** `FUSEAI_GET_SMART_COLUMN` Return a smart column's definition, provider restriction, rerun cost, and current run state. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `list_id` | string | Yes | ID of the list that owns the smart column. | | `column_id` | string | Yes | ID of the smart column, as returned when it was created or by the list-columns endpoint. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Get Smart Column Cell Provenance **Slug:** `FUSEAI_GET_SMART_COLUMN_CELL_PROVENANCE` Return the reasoning, research steps, source URLs, and computation metadata behind one smart-column cell. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `list_id` | string | Yes | ID of the list that owns the smart column. | | `column_id` | string | Yes | ID of the smart column, as returned when it was created or by the list-columns endpoint. | | `contact_id` | string | Yes | ID of the row whose cell to inspect: a contact ID on contact lists or a company ID on company lists. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Get Smart Column Job Status **Slug:** `FUSEAI_GET_SMART_COLUMN_JOB_STATUS` Poll a smart-column run and return its progress, terminal state, row counts, credit usage, and lifecycle timestamps. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `job_id` | string | Yes | ID of the smart-column run returned by a create, rerun, or prompt-edit call. | | `list_id` | string | Yes | ID of the list that owns the smart column. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Get Website Intent Analytics **Slug:** `FUSEAI_GET_WEBSITE_INTENT_ANALYTICS` Return website intent metrics, a zero-filled visitor time series, and the top visiting companies and identified people over a rolling 7-, 30-, or 90-day window. Website tracking must already be configured. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `range` | string ("7d" | "30d" | "90d") | No | Rolling analytics window ending now. Use 7d for daily buckets or 30d or 90d for ISO-week buckets. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Get Website Tracking **Slug:** `FUSEAI_GET_WEBSITE_TRACKING` Return the account's website-tracking configuration, including tracked domains and pages, the installation script, and monthly credit usage. #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### List Agents **Slug:** `FUSEAI_LIST_AGENTS` Return one page of the connected user's agents across every kind, including their lifecycle state, results-list references, and delivered-result counts. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `limit` | integer | No | Number of agents to return on this page (1-100). | | `next_cursor` | string | No | Continuation cursor returned by the previous call. Omit for the first page; it retains the original page size. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### List Agent Types **Slug:** `FUSEAI_LIST_AGENT_TYPES` Return all available agent types across signal, watcher, and scrape categories, with their creation slugs and display names. #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### List Campaign Leads **Slug:** `FUSEAI_LIST_CAMPAIGN_LEADS` Return one page of a campaign's enrolled leads with sequence progress, engagement state, recorded outcomes, and first-contact details. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `limit` | integer | No | Number of campaign leads to return on this page (1-100). | | `search` | string | No | Literal, case-insensitive substring matched against each lead's full name or company name. | | `campaign_id` | string | Yes | 24-character hexadecimal campaign ID returned when the campaign was created or listed. | | `next_cursor` | string | No | Continuation cursor returned by the previous call. Omit for the first page; it retains the campaign ID, page size, and search term. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### List Campaigns **Slug:** `FUSEAI_LIST_CAMPAIGNS` Return one page of the connected user's campaigns with headline delivery and engagement analytics, optionally filtered by name, type, status, or folder. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `type` | string ("ai-generated" | "manual") | No | Restrict results to AI-generated or manual campaigns. | | `limit` | integer | No | Number of campaigns to return on this page (1-100). | | `search` | string | No | Case-insensitive regular expression matched against campaign names. Escape regular-expression metacharacters to match them literally. | | `status` | string ("active" | "initializing" | "initialization_failed" | "stopped" | "paused_manual") | No | Restrict results to one campaign state: initializing, active, stopped, paused_manual, or initialization_failed. | | `folder_id` | string | No | Return only campaigns filed in this sequences-folder ID. | | `next_cursor` | string | No | Continuation cursor returned by the previous call. Omit for the first page; it retains the original page size and filters. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### List Campaign Steps **Slug:** `FUSEAI_LIST_CAMPAIGN_STEPS` Return a campaign's ordered sequence steps, including each step's channel, content mode, delay, manual subject and body, and AI topic and title configuration. Subject and body may be null for AI-written steps; use GENERATE_CAMPAIGN_STEP_PREVIEW to render AI copy. Use the returned step IDs when updating or previewing campaign-step content. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `campaign_id` | string | Yes | 24-character hexadecimal campaign ID returned when the campaign was created or listed. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### List Campaign Templates **Slug:** `FUSEAI_LIST_CAMPAIGN_TEMPLATES` Return up to the 100 most recent campaign templates visible to the workspace, including saved schedules and full step sequences. Use a returned template ID as templateId when creating a campaign. Fuse provides no way to request later pages; inspect pagination.total to detect omitted older templates. #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### List Campaign Variables **Slug:** `FUSEAI_LIST_CAMPAIGN_VARIABLES` List the custom and smart-column personalization variables available to a campaign. Paste a returned token verbatim into a campaign step's subject or body; built-in tokens are always available and are not returned. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `campaign_id` | string | Yes | 24-character hexadecimal campaign ID returned when the campaign was created or listed. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### List Contact Activities **Slug:** `FUSEAI_LIST_CONTACT_ACTIVITIES` Return one newest-first page of a contact's email, LinkedIn, call, CRM, and scheduled campaign activity timeline. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `limit` | integer | No | Maximum history entries per page (1-100). The first page can exceed this value because scheduled campaign steps and LinkedIn activity are added separately. | | `contact_id` | string | Yes | Contact ID from a prospect-list row or the contact-resolution endpoint. | | `next_cursor` | string | No | Continuation cursor returned by the previous call. Omit for the first page; it retains the contact ID and page size. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### List Folders **Slug:** `FUSEAI_LIST_FOLDERS` Return every folder of one requested kind owned by the connected user. Use contactList or companyList for prospect-list folders, campaign for campaign folders, or agent for agent folders. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `type` | string ("contactList" | "companyList" | "campaign" | "agent") | Yes | Folder kind to list: contactList or companyList for prospect lists, campaign for campaigns, or agent for agents. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### List Integrations **Slug:** `FUSEAI_LIST_INTEGRATIONS` Return the CRM integrations connected by the team. Use this before pushing a prospect list to a CRM to confirm that the target provider is connected. #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### List Knowledge Hub Pages **Slug:** `FUSEAI_LIST_KNOWLEDGE_HUB_PAGES` Return the knowledge pages used to ground campaign generation for a knowledge hub, including each page's full Markdown content and origin. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `hub_id` | string | Yes | 24-character hexadecimal ID of the knowledge hub, from List Knowledge Hubs. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### List Knowledge Hubs **Slug:** `FUSEAI_LIST_KNOWLEDGE_HUBS` Return all knowledge hubs owned by the connected user, including each hub's build status and whether it is the default for AI campaign grounding. #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### List Learned Facts **Slug:** `FUSEAI_LIST_LEARNED_FACTS` Return active anonymized facts learned from the team's emails, LinkedIn messages, calls, and meeting transcripts. Results cover every teammate and knowledge hub and are sorted by category, then newest first. #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### List List Columns **Slug:** `FUSEAI_LIST_LIST_COLUMNS` Return a prospect list's custom and smart column definitions. Column IDs identify entries in row column-values and are required by column update and delete operations. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `list_id` | string | Yes | 24-character hexadecimal ID of the prospect list. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### List Prospect List Rows **Slug:** `FUSEAI_LIST_PROSPECT_LIST_ROWS` Return one page of contacts or companies from a prospect list, including resource IDs, enrichment fields, list memberships, and custom column values. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `limit` | integer | No | Number of rows to return on this page (1-1000). | | `filters` | string | No | JSON object encoded as a string that filters rows. Values within one key are OR-joined and different keys are AND-joined; unknown keys or invalid value shapes are rejected. | | `list_id` | string | Yes | 24-character hexadecimal ID of the prospect list. | | `sort_by` | string | No | Field used to sort rows when sort_order is also provided. Use a contact or company field, or customColumns_; unknown fields retain the list's default order. | | `sort_order` | string ("asc" | "desc") | No | Sort direction. Required for sort_by to take effect. | | `next_cursor` | string | No | Continuation cursor returned by the previous call. Omit for the first page; it retains the list ID, page size, sort, and filters. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### List Prospect Lists **Slug:** `FUSEAI_LIST_PROSPECT_LISTS` Return one page of the connected user's prospect lists, optionally filtered by list kind, folder, or a case-insensitive name substring. System-generated lists are excluded. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `limit` | integer | No | Number of prospect lists to return on this page (1-1000). | | `search` | string | No | Case-insensitive literal substring to match against list names. Asterisks and question marks are treated as ordinary characters. | | `folder_id` | string | No | Return only lists in this 24-character hexadecimal folder ID. | | `entity_type` | string ("contactList" | "companyList") | No | Restrict results to contactList for people or companyList for companies; omit to return both kinds. | | `next_cursor` | string | No | Continuation cursor returned by the previous call. Omit for the first page; the cursor retains the original page size and filters. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### List Research Providers **Slug:** `FUSEAI_LIST_RESEARCH_PROVIDERS` Return the Deep Research providers available to the connected user, with their capabilities, credential readiness, and run availability. #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### List Research Run Events **Slug:** `FUSEAI_LIST_RESEARCH_RUN_EVENTS` Return one page of a research run's durable progress log in ascending event sequence order, including its current lifecycle status. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `limit` | integer | No | Maximum number of progress events to return on this page (1-500). | | `run_id` | string | Yes | 24-character hexadecimal research run ID returned when the run was started. | | `next_cursor` | string | No | Continuation cursor returned by the previous call. Omit for the first page; it retains the research run ID and page size. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### List Research Runs **Slug:** `FUSEAI_LIST_RESEARCH_RUNS` List up to 50 research runs that are currently in flight for the connected account, newest first. Finished runs are not returned. #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### List Saved Searches **Slug:** `FUSEAI_LIST_SAVED_SEARCHES` Return the connected user's saved people and company searches. Each result includes filters that can be sent back to the matching search endpoint. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `type` | string ("people" | "company") | No | Restrict results to people or company searches; omit to return both. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### List Scheduled Sends **Slug:** `FUSEAI_LIST_SCHEDULED_SENDS` Return one page from a campaign's send queue for a required status, optionally restricted to one delivery channel. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `limit` | integer | No | Number of scheduled sends to return on this page (1-100). | | `status` | string ("approval_required" | "scheduled" | "sent" | "skipped" | "stopped" | "overwritten") | Yes | Queue bucket to list: approval_required, scheduled, sent, skipped, stopped, or overwritten. | | `channel` | string ("email" | "linkedin_connection" | "linkedin_message" | "linkedin_visit" | "linkedin_like" | "inmail" | "dialer" | "todo") | No | Restrict results to one delivery channel; omit to include all channels. | | `campaign_id` | string | Yes | 24-character hexadecimal campaign ID returned when the campaign was created or listed. | | `next_cursor` | string | No | Continuation cursor returned by the previous call. Omit for the first page; it retains the campaign ID, status, channel, and page size. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### List Sending Accounts **Slug:** `FUSEAI_LIST_SENDING_ACCOUNTS` List connected email mailboxes or LinkedIn seats available for campaign sending, including connection status and channel-specific account details. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `channel` | string ("email" | "linkedin") | Yes | Sending channel to list: email for connected mailboxes or linkedin for connected LinkedIn seats. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### List Team Members **Slug:** `FUSEAI_LIST_TEAM_MEMBERS` Return up to 100 active members of the connected user's team, including their Fuse user IDs, email addresses, and display names. #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### List Website Visitors **Slug:** `FUSEAI_LIST_WEBSITE_VISITORS` Return one page of the connected team's all-time deanonymized website visitor feed, grouped by identified people or visiting companies. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `type` | string ("people" | "companies") | Yes | Feed to return: people for identified visitors or companies for visiting companies. | | `search` | string | No | Case-insensitive name search. It matches person names in the people feed and company names in the companies feed; percent and underscore characters act as wildcards. | | `sort_by` | string ("lastVisitDate" | "count" | "companyName" | "name" | "companySize" | "companyIndustry" | "department" | "location" | "confidenceInterval") | No | Field used to sort the visitor feed. | | `page_size` | integer | No | Number of visitor rows to return on this page (1-100). | | `sort_order` | string ("asc" | "desc") | No | Sort direction for the visitor feed. | | `next_cursor` | string | No | Continuation cursor returned by the previous call. Omit for the first page; it retains the feed, page size, search, and sorting options. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### List Writing Styles **Slug:** `FUSEAI_LIST_WRITING_STYLES` Return the account's writing styles accepted by AI campaigns. Use a returned ID as writingStyleId when creating an AI campaign. #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Pause Agent **Slug:** `FUSEAI_PAUSE_AGENT` WARNING: Permanently pause a running or expired FuseAI agent. Provider subscriptions and recurring schedules stop, no further results are delivered or billed, and already-delivered rows remain. This cannot be undone: Fuse provides no resume operation and activation accepts drafts only; duplicate and activate a copy to restore equivalent monitoring. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `agent_id` | string | Yes | ID of the running or expired agent to pause. WARNING: Pausing is one-way through the API; this agent cannot be resumed, so restoring equivalent monitoring requires duplicating and activating a copy. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Preview Import **Slug:** `FUSEAI_PREVIEW_IMPORT` Parse and preview a CSV, XLS, or XLSX import without writing contacts to a destination list. Provide exactly one direct file up to 10 MiB or the import ID of a completed large-file external upload. Review the detected headers, sample rows, and suggested mapping, then use Commit Import explicitly to create persistent contacts. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `file` | object | No | CSV, XLS, or XLSX file to upload and preview directly, up to 10 MiB. Provide exactly one of file or import_id; use Create Large Import Upload Target for a file over 10 MiB. | | `import_id` | string | No | Import ID returned by Create Large Import Upload Target after the caller has PUT the complete file to its external upload URL. Provide exactly one of import_id or file. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Push List To CRM **Slug:** `FUSEAI_PUSH_LIST_TO_CRM` Start an asynchronous push to a connected CRM. Fuse exposes no job or status endpoint for this work, so the action cannot poll for completion. Omitting contact_ids pushes every contact in the list without overwriting existing CRM records; providing contact_ids pushes exactly those IDs without intersecting them with the list and may overwrite fields on existing CRM records. This action provides no rollback for changes already made in the CRM. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `crm` | string ("hubspot" | "salesforce" | "zoho" | "attio" | "pipedrive") | Yes | Connected CRM that receives the contacts: hubspot, salesforce, zoho, attio, or pipedrive. | | `list_id` | string | Yes | 24-character hex ID of the prospect list whose contacts will be pushed. | | `contact_ids` | array | No | Optional selection of 1-500 contact IDs to push instead of the whole list. The IDs are not intersected with the list, and selecting contacts overwrites fields on CRM records that already exist. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Refresh Knowledge Hub Website **Slug:** `FUSEAI_REFRESH_KNOWLEDGE_HUB_WEBSITE` Start an external re-crawl of one website already attached to a FuseAI knowledge hub and regenerate the knowledge pages derived from that website. This mutates the hub asynchronously and immediately changes its status to processing. The crawl does not revisit previously discovered subpages or regenerate their existing text; if subpage discovery is enabled, it can add newly discovered subpages. Refresh an existing subpage by passing that subpage's own URL, then poll the hub until its status is complete. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `url` | string | Yes | URL already listed in the hub's website details. FuseAI matches it without regard to the scheme or www prefix, then starts an external crawl of that website. Pass a discovered subpage's own URL to refresh that subpage. | | `hub_id` | string | Yes | 24-character hexadecimal ID of the knowledge hub whose website should be re-crawled. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Regenerate Campaign Step Topics **Slug:** `FUSEAI_REGENERATE_CAMPAIGN_STEP_TOPICS` Rebuild the topic plan and titles across all AI-generated steps in a FuseAI campaign so the sequence follows one narrative. Manual steps and already queued sends are not changed. This action mutates existing campaign content. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `campaign_id` | string | Yes | 24-character hexadecimal ID of the campaign whose AI-generated step topics and titles should be rebuilt. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Regenerate Knowledge Hub Page **Slug:** `FUSEAI_REGENERATE_KNOWLEDGE_HUB_PAGE` Regenerate a generated FuseAI knowledge-hub page from its cached website and note sources, discarding manual edits, re-indexing the new content, and resetting its origin to generated. FuseAI completes regeneration before responding: the returned content is final and there is no background job to poll. User-authored pages and pages whose sources were removed cannot be regenerated. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `hub_id` | string | Yes | 24-character hexadecimal ID of the knowledge hub containing the page, from the list knowledge hubs action. | | `page_id` | string | Yes | 24-character hexadecimal ID of the generated knowledge-hub page, from the list knowledge hub pages action. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Remove List Members **Slug:** `FUSEAI_REMOVE_LIST_MEMBERS` Remove up to 5,000 contacts from a prospect list by contact ID. The operation is idempotent: IDs that are not members are ignored, and contacts remain in the workspace and in every other list. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `list_id` | string | Yes | 24-character hex ID of the prospect list to remove contacts from. | | `contact_ids` | array | Yes | Contact IDs to remove from the list (1-5000). Use row IDs returned by List Prospect List Rows; contacts remain in the workspace and other lists. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Rename Folder **Slug:** `FUSEAI_RENAME_FOLDER` Rename a contact-list, company-list, campaign, or agent folder. Campaign and agent folders require their folder kind to route the request correctly. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `name` | string | Yes | New folder name (1-120 characters). It must be unique among folders of the same kind. | | `type` | string ("contactList" | "companyList" | "campaign" | "agent") | No | Folder kind. Set this to campaign or agent for those folder kinds; omit it for a contact-list or company-list folder, which resolves by ID. | | `folder_id` | string | Yes | 24-character hexadecimal ID of the folder to rename. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Rerun Smart Column **Slug:** `FUSEAI_RERUN_SMART_COLUMN` Start an asynchronous rerun of a smart column for all covered rows or only rows that have not been computed. Both modes cancel any active run before starting a replacement, and each row computed by the replacement consumes credits. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `mode` | string ("all" | "new_only") | No | Rows to compute. all recomputes every covered row; new_only computes only rows that have never been computed. Either mode cancels an active run, and each computed row consumes credits. | | `list_id` | string | Yes | ID of the list that owns the smart column. | | `column_id` | string | Yes | ID of the smart column, as returned when it was created or by the list-columns endpoint. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Resolve Contact By LinkedIn URL **Slug:** `FUSEAI_RESOLVE_CONTACT_BY_LINKEDIN_URL` Resolve an existing workspace contact ID from a LinkedIn profile URL. This read-only action does not create or modify a contact. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `linkedin_url` | string | Yes | The contact's LinkedIn profile URL (max 500 characters). Protocol, www prefix, and trailing slash are ignored when matching. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Save Company Search To List **Slug:** `FUSEAI_SAVE_COMPANY_SEARCH_TO_LIST` Run a company search and asynchronously save up to 10,000 matches into a created, reused, or existing company list. The job consumes two credits per company saved and may be partially billed if it stops early. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `limit` | integer | Yes | Maximum matching companies to save (1-10000). The asynchronous job charges two credits for each company it saves. | | `query` | string | No | Natural-language company criteria that Fuse converts into filters. Mutually exclusive with literal filters and saved-search selectors. | | `filters` | object | No | Literal company-search filters. Use provider vocabularies from the company filter-options and autocomplete actions. Mutually exclusive with saved_search_id, saved_search_name, and query. | | `list_id` | string | No | ID of an existing destination company list. Mutually exclusive with list_name. | | `list_name` | string | No | Destination company-list name. Fuse creates it when absent or reuses an exact case-insensitive match. Mutually exclusive with list_id. | | `saved_search_id` | string | No | ID of a saved company search. A saved people search is invalid. Mutually exclusive with filters, saved_search_name, and query. | | `saved_search_name` | string | No | Exact title of a saved company search. Use its ID when titles are ambiguous. Mutually exclusive with other search sources. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Save Prospect Search To List **Slug:** `FUSEAI_SAVE_PROSPECT_SEARCH_TO_LIST` Run a people search and asynchronously save up to 10,000 matches into a created, reused, or existing contact list. This runs a new metered search and can optionally spend additional per-row credits on email or phone enrichment, then attach the list to a campaign. An attachment failure does not roll back the already-started save job. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `limit` | integer | Yes | Maximum matching profiles to save (1-10000). Fuse pre-checks credits for this many rows before starting the job. | | `query` | string | No | Natural-language description of the people to find. Fuse converts it to filters; mutually exclusive with filters and saved-search selectors. | | `enrich` | string ("none" | "email" | "phone" | "phone_and_email") | No | Enrichment run on saved rows: none costs 2 credits per row; email, phone, and phone_and_email pre-check 50, 200, and 250 credits per row respectively. | | `filters` | object | No | Literal people-search filters from the prospect filter-options endpoint. Use provider field names exactly, including dotted names; include/exclude fields take [{status, value}], term fields take a string or string array, and rangeInputs contains {min, max} ranges. Mutually exclusive with saved_search_id, saved_search_name, and query. | | `list_id` | string | No | ID of an existing destination contact list. Mutually exclusive with list_name. | | `list_name` | string | No | Destination contact-list name. Fuse creates it when absent or reuses an exact case-insensitive match. Mutually exclusive with list_id. | | `campaign_id` | string | No | Optional campaign ID to attach to the destination list after saving starts. Mutually exclusive with campaign_name. | | `campaign_name` | string | No | Optional exact campaign name to attach to the destination list after saving starts. Mutually exclusive with campaign_id. | | `saved_search_id` | string | No | ID of a people saved search whose filters should be used. Mutually exclusive with filters, saved_search_name, and query. | | `saved_search_name` | string | No | Exact title of a people saved search whose filters should be used. Mutually exclusive with filters, saved_search_id, and query. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Search Companies **Slug:** `FUSEAI_SEARCH_COMPANIES` Return one metered page of companies matching literal filters, a saved company search, or a natural-language query. Continuation cursors retain the complete original request body context. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `size` | integer | No | Companies to request for this page (1-100). Fuse pre-checks two credits per requested company and charges two per company returned. | | `query` | string | No | Natural-language description of companies to find, converted to filters by Fuse. Use instead of filters or a saved search. | | `filters` | object | No | Literal company filters. Use this instead of a saved search or natural-language query, and provide at least one non-empty filter. | | `next_cursor` | string | No | Opaque continuation cursor returned by the previous call. Omit for the first page; it retains the complete original body context. | | `saved_search_id` | string | No | ID of a saved company search whose filters should be used instead of filters, saved_search_name, or query. | | `saved_search_name` | string | No | Exact title of a saved company search whose filters should be used. Use its ID when multiple saved searches share the title. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Search Prospects **Slug:** `FUSEAI_SEARCH_PROSPECTS` Return one metered page of people matching literal filters, a saved people search, or a natural-language query. Continuation cursors retain the exact original body filters and search inputs. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `size` | integer | No | Profiles to request for this page (1-100). Fuse pre-checks two credits per requested profile and charges two per profile returned. | | `query` | string | No | Natural-language description of people to find, converted to filters by Fuse. Use instead of filters or a saved search. | | `filters` | object | No | Literal people-search filters. Use field names and values from GET /prospects/filter-options; include/exclude fields take arrays of {status, value} objects, term fields take a string or string array, and rangeInputs contains {min, max} ranges. Use this instead of a saved search or natural-language query. | | `next_cursor` | string | No | Opaque continuation cursor returned by the previous call. Omit for the first page; it retains all original body filters and search inputs. | | `linkedin_url` | string | No | LinkedIn profile URL to normalize and match as additional search criteria. | | `saved_search_id` | string | No | ID of a saved people search whose filters should be used instead of filters, saved_search_name, or query. | | `saved_search_name` | string | No | Exact title of a saved people search whose filters should be used. Use its ID instead if multiple saved searches have the same title. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Set Default Knowledge Hub **Slug:** `FUSEAI_SET_DEFAULT_KNOWLEDGE_HUB` Make one of the connected FuseAI user's knowledge hubs the default used when a campaign does not specify a knowledge hub. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `hub_id` | string | Yes | ID of the owned knowledge hub to make the default. Every other owned hub loses the default flag. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Skip Scheduled Send **Slug:** `FUSEAI_SKIP_SCHEDULED_SEND` WARNING: Irreversibly skip one queued campaign send. This cannot be undone and advances the contact's sequence to its next step; the next step's wait is measured from the skipped send's scheduled time. Use Decline Scheduled Send instead when the contact's sequence should stop. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `send_id` | string | Yes | ID of the queued campaign send to skip, from a scheduled-sends list response. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Start Research Run **Slug:** `FUSEAI_START_RESEARCH_RUN` Start an autonomous FuseAI Deep Research run and return immediately with its ID. WARNING: this starts external provider work and consumes FuseAI credits per provider action, up to the selected effort cap. Supply an idempotency_key and reuse it for identical retries to avoid duplicate work and charges. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `effort` | string ("low" | "medium" | "high") | No | Research depth and credit-spend cap: low allows up to 1000 credits, medium up to 2000, and high up to 5000. Omit for medium. WARNING: provider actions performed by the external research run consume credits. | | `prompt` | string | Yes | Research question or brief (4-2000 characters). WARNING: submitting this prompt starts autonomous external research work that consumes FuseAI credits. | | `idempotency_key` | string | No | Stable key for safe retries (8-200 characters). Reuse the same key only for an identical retry so FuseAI returns the existing run instead of starting and potentially charging for duplicate external work. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Stop Campaign **Slug:** `FUSEAI_STOP_CAMPAIGN` Stop an owned FuseAI campaign. Sending halts immediately and open task mirrors are cleared, but per-contact state is preserved so Approve Campaign can resume the same campaign later. A draft campaign may also be parked in the stopped state. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `campaign_id` | string | Yes | ID of the owned campaign to stop. This may be an active campaign or a draft campaign that should be parked in the stopped state. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Update Agent **Slug:** `FUSEAI_UPDATE_AGENT` Update one or more type-specific config fields on a FuseAI draft agent. Only agents in initializing status are editable; duplicate an active, paused, expired, failed, or completed agent before changing it. The patch does not activate the agent or consume credits. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `config` | string | Yes | One or more snake_case fields for the selected agent type. Omitted fields keep their values, arrays replace stored arrays, and start is unavailable. | | `agent_id` | string | Yes | 24-character hexadecimal ID of the draft agent to update, returned by List Agents or an agent create or duplicate operation. | | `agent_type` | string ("web-monitor" | "person-starting-new-job" | "linkedin-posts" | "person-discovery-via-filters" | "job-postings" | "job-posting-in-location" | "first-person-hired-in-company-department" | "first-person-hired-internationally" | "company-headcount-growth" | "company-headcount-growth-over-baseline" | "company-department-headcount" | "company-employee-job-location-in-two-countries" | "funding-announcements" | "people-watcher" | "companies-watcher" | "job-changes-watcher" | "linkedin-profile" | "linkedin-post") | Yes | The draft's agent type. Selects the strict config patch schema and is not sent to FuseAI. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Update Campaign **Slug:** `FUSEAI_UPDATE_CAMPAIGN` Update one or more settings on a FuseAI campaign, including its schedule, source and exclusion lists, enrollment rules, tracking, delegates, and call-to-action link. Only explicitly supplied settings are changed. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `cta_link` | string | No | Absolute HTTP(S) call-to-action URL. Pass null or an empty string explicitly to clear it; queued sends using the old link are rewritten. | | `list_ids` | array | No | Replacement set of 1-10 contact-list IDs used as campaign sources. Changing these IDs does not enroll newly added contacts in an already running campaign by itself. | | `timezone` | string | No | IANA time zone used for sending windows and email days. Use a region such as America/New_York rather than an abbreviation such as EST. | | `delegates` | array | No | Replacement list of teammate user IDs allowed to view and edit the campaign. Use IDs from the team-members endpoint and pass an empty list to revoke all delegates. | | `email_days` | array | No | Replacement set of 1-7 distinct weekdays on which sends may occur. Omitted weekdays are skipped. | | `is_dynamic` | boolean | No | Whether contacts added to source lists after activation are enrolled automatically. | | `campaign_id` | string | Yes | ID of the campaign to update. | | `campaign_name` | string | No | New campaign display name (1-200 characters). | | `exclude_lists` | array | No | Replacement set of up to 10 contact-list IDs whose members are excluded from future enrollment. Pass an empty list to clear this exclusion. | | `exclude_contacted` | string ("none" | "ever" | "last_1_month" | "last_3_months" | "last_6_months" | "last_1_year") | No | How far back to exclude contacts reached by another campaign. Pending recipients in active campaigns are always excluded. | | `use_linkedin_posts` | boolean | No | Whether activation fetches recent LinkedIn posts for AI personalization. | | `campaign_start_date` | string | No | New ISO 8601 start date-time. This reschedules still-pending sends for the campaign's first step. | | `add_unsubscribe_link` | boolean | No | Whether every email step includes a one-click unsubscribe footer. | | `exclude_company_lists` | array | No | Replacement set of up to 20 company or contact-list IDs whose companies are excluded from future enrollment. Pass an empty list to clear it. | | `exclude_engaged_contacts` | boolean | No | Whether to exclude contacts who previously replied to a campaign. | | `open_rate_tracking_enabled_at` | string | No | ISO 8601 timestamp from which open tracking is enabled. Pass null explicitly to disable open tracking. | | `send_only_to_validated_emails_enabled_at` | string | No | ISO 8601 timestamp from which future enrollment only accepts validated email addresses. Pass null explicitly to also allow catch-all and never-verified uploaded addresses. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Update Campaign Step **Slug:** `FUSEAI_UPDATE_CAMPAIGN_STEP` Update the content, AI topic, or delay of one FuseAI campaign sequence step. For manual-step content, subject and body must be updated together. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `body` | string | No | Replacement message for a manual step, up to 50000 characters. It may be empty and may contain HTML, variables, or spintax, but must be supplied together with subject. For a LinkedIn connection step, keep the invitation note at 200 characters or fewer. AI steps ignore it. | | `topic` | string | No | New free-text topic for an AI-generated or AI-reply step, up to 1000 characters. Updating it also regenerates the step title. Manual steps store the topic but do not render from it. | | `step_id` | string | Yes | ID of the sequence step to update. | | `subject` | string | No | Replacement subject for a manual step, up to 500 characters. It may be empty, but must be supplied together with body. AI steps ignore it. | | `campaign_id` | string | Yes | ID of the campaign that owns the sequence step. | | `days_between` | integer | No | Whole days to wait after the previous step, or after campaign start for the first step, from 0 to 365. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Update Column Values **Slug:** `FUSEAI_UPDATE_COLUMN_VALUES` Write up to 500 values into one custom column on a Fuse prospect list, keyed by contact row ID. Values must match the column's configured type. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `values` | array | Yes | Cells to write, one per contact. Every contact must already be a row in the list. A request may contain 1-500 distinct contacts. | | `list_id` | string | Yes | 24-character hexadecimal ID of the prospect list. | | `column_id` | string | Yes | 24-character hexadecimal ID of the custom column to update. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Update Contact **Slug:** `FUSEAI_UPDATE_CONTACT` Promote an existing email address, phone number, or both to be a contact's primary values. The values must already belong to the contact. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `contact_id` | string | Yes | Contact ID from a prospect-list row or from the contact resolution endpoint. | | `primary_email` | string | No | Email address to promote to primary. It must already be one of the contact's email addresses; this action does not add a new address. | | `primary_phone` | string | No | Phone number to promote to primary, written exactly as it appears on the contact. It must already belong to the contact. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Update Knowledge Hub **Slug:** `FUSEAI_UPDATE_KNOWLEDGE_HUB` Rename a FuseAI knowledge hub or merge websites and notes into it. The asynchronous rebuild starts immediately; poll the hub until its status is complete to read the merged content. This operation never removes sources. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `name` | string | No | New hub name (1-100 characters). | | `notes` | array | No | One to fifty notes to add or update by exact filename. Duplicate filenames in one call collapse to the last entry, and no notes are removed. | | `hub_id` | string | Yes | 24-character hexadecimal ID of the knowledge hub to update. | | `websites` | array | No | One to twenty websites to add or re-crawl. Existing entries are replaced by normalized URL match; unknown URLs are added, and none are removed. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Update Knowledge Hub Page **Slug:** `FUSEAI_UPDATE_KNOWLEDGE_HUB_PAGE` Replace the title, Markdown content, or both for a page in a completed FuseAI knowledge hub. FuseAI re-indexes the page before returning. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `title` | string | No | Replacement page title (1-200 characters). | | `hub_id` | string | Yes | 24-character hexadecimal ID of the knowledge hub that owns the page. | | `content` | string | No | Replacement Markdown body (1-60,000 characters). Editing a generated page marks it as edited, but a later source refresh may regenerate it. | | `page_id` | string | Yes | 24-character hexadecimal ID of the page, from List Knowledge Hub Pages. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Update Learned Fact **Slug:** `FUSEAI_UPDATE_LEARNED_FACT` Correct the claim text or category of an active FuseAI learned fact. Claim changes must remain anonymized and appear in knowledge-hub pages after the next daily learning run. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `claim` | string | No | Corrected anonymized claim text. Do not include person or customer names, email addresses, phone-like digit sequences, currency amounts with deal language, or contract details. The correction reaches knowledge-hub pages on the next daily learning run. | | `fact_id` | string | Yes | 24-character hexadecimal ID of the learned fact to update. | | `category` | string ("overview" | "products" | "pricing" | "icp-use-cases" | "differentiators" | "competitors" | "faq" | "source-digest" | "custom" | "objection" | "faq-insight") | No | Replacement fact category: overview, products, pricing, icp-use-cases, differentiators, competitors, faq, source-digest, custom, objection, or faq-insight. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Update Prospect List **Slug:** `FUSEAI_UPDATE_PROSPECT_LIST` Rename a Fuse prospect list or move it into an existing or newly named folder. Only explicitly supplied fields are changed. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `name` | string | No | New list name. Fuse trims it and requires it to be unique in the workspace. Omit it to keep the current name. | | `list_id` | string | Yes | 24-character hexadecimal ID of the prospect list to update. | | `folder_id` | string | No | ID of an existing folder for the list's entity type. Pass null explicitly to move the list to the root; omit it to leave the folder unchanged. Mutually exclusive with folder_name. | | `folder_name` | string | No | Exact folder name to move the list into, matched case-insensitively. Fuse creates a folder for the list's entity type if none exists. Mutually exclusive with folder_id. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Update Saved Search **Slug:** `FUSEAI_UPDATE_SAVED_SEARCH` Rename a saved people or company search, replace all of its filters, or do both. The search type cannot be changed, and filter replacement is not a merge. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `title` | string | No | New display name (1-255 characters). Omit it to keep the current title. | | `filters` | string | No | Complete replacement filters in the saved search's existing vocabulary. Use prospect-search fields for people searches and company-search fields for company searches. The replacement must be non-empty; first_name and last_name cannot be stored for people searches. | | `filter_type` | string ("people" | "company") | No | Existing immutable search type. Required when replacing filters so the replacement is validated against the correct vocabulary; never sent. | | `saved_search_id` | string | Yes | 24-character hexadecimal ID of the saved search to update. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Update Scheduled Send **Slug:** `FUSEAI_UPDATE_SCHEDULED_SEND` Replace the copy or send time of a queued FuseAI campaign send before it goes out. Fuse creates a new queued row, so use the returned new ID for any later edit. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `body` | string | No | Replacement message body, up to 20000 characters. Variable tokens such as {First Name} are substituted at send time; omit it to keep the current body. | | `send_id` | string | Yes | ID of the queued send to replace. Use the 24-character hexadecimal _id from a list scheduled sends call. | | `subject` | string | No | Replacement subject, up to 500 characters. It may be empty; omit it to keep the queued send's current subject. | | `scheduled_at` | string | No | Replacement ISO 8601 send time in UTC. Omit it to keep the current send time. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Update Smart Column **Slug:** `FUSEAI_UPDATE_SMART_COLUMN` Rename a FuseAI smart column, change its research prompt, or change a Deep Research provider restriction. Prompt changes may consume credits by starting an immediate recomputation. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `name` | string | No | New display name. It must remain unique on the list and cannot be a reserved built-in column name. | | `prompt` | string | No | New research instruction. Changing it cancels an active run and starts a billed recomputation of previously computed or unfinished rows. | | `list_id` | string | Yes | ID of the list that owns the smart column. | | `column_id` | string | Yes | ID of the smart column, as returned when it was created or by the list-columns endpoint. | | `provider_ids` | array | No | For deep_research columns only, 1-50 distinct provider IDs from the research-providers endpoint. Pass null explicitly to clear the restriction; the selection applies from the next run and does not recompute rows. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Update Website Tracking **Slug:** `FUSEAI_UPDATE_WEBSITE_TRACKING` Replace FuseAI's tracked domains and page labels, change the monthly visitor deanonymization credit cap, or do both. Provide at least one of domains, tracked_pages, or monthly_credit_limit; tracked_pages requires domains in the same request. Domain and page arrays are full replacements; read the current configuration first to preserve existing values. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `domains` | array | No | Replacement list of up to 50 domains where the tracking script is installed. This replaces the complete stored list, so first read the current tracking configuration and include every domain to retain. Use bare hostnames such as brightpay.com; pass an empty list to clear it. | | `tracked_pages` | array | No | Replacement list of up to 200 free-text page labels reported separately, such as pricing or home. This replaces the complete stored list and must be supplied together with domains. Each label produces data only after its page-specific tracking script is installed. | | `monthly_credit_limit` | integer | No | Monthly deanonymization credit cap from 0 to 10,000,000. Zero pauses deanonymization; pass null explicitly to remove the custom cap and use the plan allowance. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Upload Knowledge Hub Attachment **Slug:** `FUSEAI_UPLOAD_KNOWLEDGE_HUB_ATTACHMENT` Attach a document to one note in a completed FuseAI knowledge hub. Only the current hub owner can upload an attachment. The file is stored for download but is not indexed as knowledge; add learnable content to the note text. Each note accepts only one attachment, and an ambiguous failure should be checked before retrying to avoid a duplicate conflict. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `file` | object | Yes | PDF, plain-text, CSV, Word, or RTF document to attach. Fuse limits the complete JSON request body to 10 MiB, including the base64 data, note ID, filename, MIME type, JSON field names, and escaping. Keep the encoded file below 10 MiB with room for that metadata; the exact file limit varies with the filename and MIME type. | | `hub_id` | string | Yes | 24-character hexadecimal ID of the knowledge hub that will receive the attachment. | | `note_id` | string | Yes | 24-character hexadecimal ID of the note that will receive the document. Each note can hold at most one attachment. | | `filename` | string | Yes | File name stored with the attachment (1-255 characters). Include the document's real extension. | | `content_type` | string ("application/pdf" | "text/plain" | "text/csv" | "application/msword" | "application/vnd.openxmlformats-officedocument.wordprocessingml.document" | "application/rtf") | Yes | MIME type of the PDF, plain-text, CSV, Word, or RTF document. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Upload List Contacts **Slug:** `FUSEAI_UPLOAD_LIST_CONTACTS` Create up to 500 raw contacts and add them to a contact prospect list without enrichment or deduplication. Retrying the same request creates duplicate rows. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `list_id` | string | Yes | 24-character hex ID of the contact list that will receive the new contacts. | | `contacts` | array | Yes | Contacts to create as new rows, in order. Fuse does not deduplicate them, enrich them, or verify their data. Every row must provide at least one of first_name, last_name, email, or linkedin_url. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not |