> ## Documentation Index
> Fetch the complete documentation index at: https://docs.modulex.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Wiza Integration for AI Agents & Workflows

> Find, enrich, and verify B2B contact data with Wiza. Search prospects, enrich companies, reveal verified emails and phone numbers for individuals, and check your account credit balance.

{/* Self-hosted logo — build-time vendored from modulex.json / Iconify (see scripts/lib/logo.js). */}

<img src="https://mintcdn.com/modulexaillc/df8MOr-hXotYLTh5/logos/placeholder.svg?fit=max&auto=format&n=df8MOr-hXotYLTh5&q=85&s=a4046f9cd6d738c81259050e9833913c" alt="Wiza logo" width="72" height="72" data-path="logos/placeholder.svg" />

## Overview

Add **Wiza** to any ModuleX agent or workflow. Find, enrich, and verify B2B contact data with Wiza — prospect search, company enrichment, individual contact reveal (verified emails and phone numbers), and credit-balance lookup against the Wiza REST API (`wiza.co/api`).

<Info>
  **Categories**: Sales · Enrichment · Sales Engagement · **Auth**: API Key · **Actions**: 4
</Info>

## Authentication

### API Key Authentication

Authenticate using your Wiza API key

<Steps>
  <Step title="Step 1">
    Log in to your Wiza account at [https://app.wiza.co](https://app.wiza.co)
  </Step>

  <Step title="Step 2">
    Open Settings -> API and generate a new API key (or copy an existing one)
  </Step>

  <Step title="Step 3">
    Paste the API key below
  </Step>
</Steps>

#### Required Credentials

| Field        | Description                            | Required | Format |
| ------------ | -------------------------------------- | -------- | ------ |
| Wiza API Key | Your Wiza API key from Settings -> API | Yes      | `-`    |

## Available Actions

<AccordionGroup>
  <Accordion title="prospect_search — Search Wiza's database of prospects using person, company, and financial filters.">
    ### Parameters

    <ResponseField name="size" type="integer">
      Number of sample profiles to return (0-30, default 0 returns total only)
    </ResponseField>

    <ResponseField name="filters" type="object">
      Full filters object (overrides individual filter params if provided)
    </ResponseField>

    <ResponseField name="first_name" type="array">
      Exact first names to match (e.g., \["John", "Jane"])
    </ResponseField>

    <ResponseField name="last_name" type="array">
      Exact last names to match
    </ResponseField>

    <ResponseField name="job_title" type="array">
      Job titles to include/exclude (e.g., \[\{"v":"CEO","s":"i"}])
    </ResponseField>

    <ResponseField name="job_title_level" type="array">
      Seniority levels (e.g., \["cxo", "director", "manager"])
    </ResponseField>

    <ResponseField name="job_role" type="array">
      Job role categories (e.g., \["sales", "engineering"])
    </ResponseField>

    <ResponseField name="job_sub_role" type="array">
      Detailed role categories (e.g., \["software", "product"])
    </ResponseField>

    <ResponseField name="location" type="array">
      Person location filters (city/state/country with include/exclude)
    </ResponseField>

    <ResponseField name="skill" type="array">
      Professional skills (e.g., \["python", "marketing"])
    </ResponseField>

    <ResponseField name="school" type="array">
      Educational institutions
    </ResponseField>

    <ResponseField name="major" type="array">
      Field of study
    </ResponseField>

    <ResponseField name="linkedin_slug" type="array">
      LinkedIn profile slugs
    </ResponseField>

    <ResponseField name="job_company" type="array">
      Current company filters (include/exclude)
    </ResponseField>

    <ResponseField name="past_company" type="array">
      Past company filters (include/exclude)
    </ResponseField>

    <ResponseField name="company_location" type="array">
      Company HQ location filters
    </ResponseField>

    <ResponseField name="company_industry" type="array">
      Company industry filters (include/exclude)
    </ResponseField>

    <ResponseField name="company_size" type="array">
      Company headcount brackets (e.g., \["11-50", "51-200"])
    </ResponseField>

    <ResponseField name="company_type" type="array">
      Company type (e.g., \["private", "public"])
    </ResponseField>

    ### Response

    ```json theme={null}
    {
      "$defs": {
        "ProspectProfile": {
          "additionalProperties": false,
          "description": "A single sample profile row in ``prospect_search``.",
          "properties": {
            "full_name": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Full Name"
            },
            "linkedin_url": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Linkedin Url"
            },
            "industry": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Industry"
            },
            "job_title": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Job Title"
            },
            "job_title_role": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Job Title Role"
            },
            "job_title_sub_role": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Job Title Sub Role"
            },
            "job_company_name": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Job Company Name"
            },
            "job_company_website": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Job Company Website"
            },
            "location_name": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Location Name"
            }
          },
          "title": "ProspectProfile",
          "type": "object"
        }
      },
      "additionalProperties": false,
      "properties": {
        "success": {
          "title": "Success",
          "type": "boolean"
        },
        "error": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Error"
        },
        "total": {
          "anyOf": [
            {
              "type": "integer"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Total"
        },
        "profiles": {
          "items": {
            "$ref": "#/$defs/ProspectProfile"
          },
          "title": "Profiles",
          "type": "array"
        }
      },
      "required": [
        "success"
      ],
      "title": "ProspectSearchOutput",
      "type": "object"
    }
    ```
  </Accordion>

  <Accordion title="company_enrichment — Enrich a company by name, domain, LinkedIn ID, or LinkedIn slug with detailed firmographic data.">
    ### Parameters

    <ResponseField name="company_name" type="string">
      Company name (e.g., "Wiza")
    </ResponseField>

    <ResponseField name="company_domain" type="string">
      Company domain (e.g., "wiza.co")
    </ResponseField>

    <ResponseField name="company_linkedin_id" type="string">
      Company LinkedIn ID
    </ResponseField>

    <ResponseField name="company_linkedin_slug" type="string">
      Company LinkedIn slug from the URL
    </ResponseField>

    ### Response

    ```json theme={null}
    {
      "additionalProperties": false,
      "properties": {
        "success": {
          "title": "Success",
          "type": "boolean"
        },
        "error": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Error"
        },
        "company_name": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Company Name"
        },
        "company_domain": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Company Domain"
        },
        "domain": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Domain"
        },
        "company_industry": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Company Industry"
        },
        "company_size": {
          "anyOf": [
            {
              "type": "integer"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Company Size"
        },
        "company_size_range": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Company Size Range"
        },
        "company_founded": {
          "anyOf": [
            {
              "type": "integer"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Company Founded"
        },
        "company_revenue_range": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Company Revenue Range"
        },
        "company_funding": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Company Funding"
        },
        "company_type": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Company Type"
        },
        "company_description": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Company Description"
        },
        "company_ticker": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Company Ticker"
        },
        "company_last_funding_round": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Company Last Funding Round"
        },
        "company_last_funding_amount": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Company Last Funding Amount"
        },
        "company_last_funding_at": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Company Last Funding At"
        },
        "company_location": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Company Location"
        },
        "company_twitter": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Company Twitter"
        },
        "company_facebook": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Company Facebook"
        },
        "company_linkedin": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Company Linkedin"
        },
        "company_linkedin_id": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Company Linkedin Id"
        },
        "company_street": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Company Street"
        },
        "company_locality": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Company Locality"
        },
        "company_region": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Company Region"
        },
        "company_postal_code": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Company Postal Code"
        },
        "company_country": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Company Country"
        },
        "credits": {
          "anyOf": [
            {
              "additionalProperties": true,
              "type": "object"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Credits"
        }
      },
      "required": [
        "success"
      ],
      "title": "CompanyEnrichmentOutput",
      "type": "object"
    }
    ```
  </Accordion>

  <Accordion title="individual_reveal — Reveal a contact via LinkedIn URL, name + company/domain, or email. Starts the reveal and polls until it resolves. Uses 2 credits per valid email and 5 credits per phone, charged only on success.">
    ### Parameters

    <ResponseField name="enrichment_level" type="string" required>
      Enrichment depth: 'none', 'partial', 'phone', or 'full'
    </ResponseField>

    <ResponseField name="profile_url" type="string">
      LinkedIn profile URL (e.g., [https://linkedin.com/in/johndoe](https://linkedin.com/in/johndoe))
    </ResponseField>

    <ResponseField name="full_name" type="string">
      Full name (used with company or domain)
    </ResponseField>

    <ResponseField name="company" type="string">
      Company name (used with full\_name)
    </ResponseField>

    <ResponseField name="domain" type="string">
      Company domain (used with full\_name)
    </ResponseField>

    <ResponseField name="email" type="string">
      Email address (use alone or with other identifiers)
    </ResponseField>

    <ResponseField name="accept_work" type="boolean">
      Whether to accept work emails (email\_options)
    </ResponseField>

    <ResponseField name="accept_personal" type="boolean">
      Whether to accept personal emails (email\_options)
    </ResponseField>

    ### Response

    ```json theme={null}
    {
      "$defs": {
        "RevealEmail": {
          "additionalProperties": false,
          "description": "A single email entry in ``individual_reveal``'s ``emails`` list.",
          "properties": {
            "email": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Email"
            },
            "email_type": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Email Type"
            },
            "email_status": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Email Status"
            }
          },
          "title": "RevealEmail",
          "type": "object"
        },
        "RevealPhone": {
          "additionalProperties": false,
          "description": "A single phone entry in ``individual_reveal``'s ``phones`` list.",
          "properties": {
            "number": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Number"
            },
            "pretty_number": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Pretty Number"
            },
            "type": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Type"
            }
          },
          "title": "RevealPhone",
          "type": "object"
        }
      },
      "additionalProperties": false,
      "properties": {
        "success": {
          "title": "Success",
          "type": "boolean"
        },
        "error": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Error"
        },
        "id": {
          "anyOf": [
            {
              "type": "integer"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Id"
        },
        "status": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Status"
        },
        "is_complete": {
          "anyOf": [
            {
              "type": "boolean"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Is Complete"
        },
        "name": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Name"
        },
        "company": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Company"
        },
        "enrichment_level": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Enrichment Level"
        },
        "linkedin_profile_url": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Linkedin Profile Url"
        },
        "title": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Title"
        },
        "location": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Location"
        },
        "email": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Email"
        },
        "email_type": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Email Type"
        },
        "email_status": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Email Status"
        },
        "emails": {
          "items": {
            "$ref": "#/$defs/RevealEmail"
          },
          "title": "Emails",
          "type": "array"
        },
        "mobile_phone": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Mobile Phone"
        },
        "phone_number": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Phone Number"
        },
        "phone_status": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Phone Status"
        },
        "phones": {
          "items": {
            "$ref": "#/$defs/RevealPhone"
          },
          "title": "Phones",
          "type": "array"
        },
        "company_size": {
          "anyOf": [
            {
              "type": "integer"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Company Size"
        },
        "company_size_range": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Company Size Range"
        },
        "company_type": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Company Type"
        },
        "company_domain": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Company Domain"
        },
        "company_locality": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Company Locality"
        },
        "company_region": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Company Region"
        },
        "company_country": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Company Country"
        },
        "company_street": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Company Street"
        },
        "company_postal_code": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Company Postal Code"
        },
        "company_founded": {
          "anyOf": [
            {
              "type": "integer"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Company Founded"
        },
        "company_funding": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Company Funding"
        },
        "company_revenue": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Company Revenue"
        },
        "company_industry": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Company Industry"
        },
        "company_subindustry": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Company Subindustry"
        },
        "company_linkedin": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Company Linkedin"
        },
        "company_location": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Company Location"
        },
        "company_description": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Company Description"
        },
        "credits": {
          "anyOf": [
            {
              "additionalProperties": true,
              "type": "object"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Credits"
        }
      },
      "required": [
        "success"
      ],
      "title": "IndividualRevealOutput",
      "type": "object"
    }
    ```
  </Accordion>

  <Accordion title="get_credits — Retrieve the remaining credits on your Wiza account.">
    ### Response

    ```json theme={null}
    {
      "additionalProperties": false,
      "properties": {
        "success": {
          "title": "Success",
          "type": "boolean"
        },
        "error": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Error"
        },
        "email_credits": {
          "anyOf": [
            {
              "type": "integer"
            },
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Email Credits"
        },
        "phone_credits": {
          "anyOf": [
            {
              "type": "integer"
            },
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Phone Credits"
        },
        "export_credits": {
          "anyOf": [
            {
              "type": "integer"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Export Credits"
        },
        "api_credits": {
          "anyOf": [
            {
              "type": "integer"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Api Credits"
        }
      },
      "required": [
        "success"
      ],
      "title": "GetCreditsOutput",
      "type": "object"
    }
    ```
  </Accordion>
</AccordionGroup>

## Limits & Quotas

* **Rate limit**: \~30 requests/minute (43,200/day) per key.
* **Credits**: usage is metered in API credits — 2 credits per valid
  email and 5 per phone on `individual_reveal`, 2 credits per
  successful `company_enrichment`; `prospect_search` and `get_credits`
  consume no credits. Credits are charged only when data is returned.
* **Asynchronous reveals**: `individual_reveal` starts a reveal and
  polls `GET /api/individual_reveals/{id}` until the status is terminal
  (`finished`/`failed`) or a 120-second window elapses.
* **Error model**: non-2xx responses and timeouts are caught and
  returned as `success=False` + `error` rather than raising. Plan for
  retries on the agent side based on the error string.

## Related integrations

<CardGroup cols={3}>
  <Card title="Enrow" href="/integrations/tools/enrow" />

  <Card title="Findymail" href="/integrations/tools/findymail" />

  <Card title="Icypeas" href="/integrations/tools/icypeas" />
</CardGroup>

## Links

* [Wiza](https://wiza.co)