Skip to content
Scalekit Docs
Talk to an Engineer Dashboard

Connect AI agents to Wiza

Scalekit connector
Open markdown

The Wiza connector lets your AI agent act in each user's Wiza account. Each user connects their own Wiza access token once, and Scalekit sends it with every call, so your agent never handles credentials. It comes with 5 tools.

Tools
5
What they doRead · write · destructive
4 · 1 · 04 read1 write0 destructive
Users sign in with

Setup

  1. Install the SDK

    Terminal window
    npm install @scalekit-sdk/node dotenv
  2. Set your credentials

    Add your Scalekit credentials to your .env file. Find values in app.scalekit.com > Developers > API Credentials.

    .env
    SCALEKIT_ENVIRONMENT_URL=<your-environment-url>
    SCALEKIT_CLIENT_ID=<your-client-id>
    SCALEKIT_CLIENT_SECRET=<your-client-secret>
  3. Create the Wiza connection

    In AgentKit > Connections, create a Wiza connection. The name you give it is the connection_name your code passes. See Configure connections.

  4. Authorize a user and make your first call

    quickstart.mts
    import { ScalekitClient } from '@scalekit-sdk/node'
    import 'dotenv/config'
    import { createInterface } from 'node:readline/promises'
    const scalekit = new ScalekitClient(
    process.env.SCALEKIT_ENVIRONMENT_URL,
    process.env.SCALEKIT_CLIENT_ID,
    process.env.SCALEKIT_CLIENT_SECRET,
    )
    const actions = scalekit.actions
    const connector = 'wiza'
    const identifier = 'user_123'
    // Generate an authorization link for the user
    const { link } = await actions.getAuthorizationLink({ connectionName: connector, identifier })
    console.log('Authorize Wiza:', link)
    const rl = createInterface({ input: process.stdin, output: process.stdout })
    await rl.question('Press Enter after authorizing...')
    rl.close()
    // Make your first call
    const result = await actions.executeTool({
    connector,
    identifier,
    toolName: 'wiza_company_enrichment',
    toolInput: {},
    })
    console.log(result)
    Terminal window
    npx tsx quickstart.mts

    Each user opens the link once and enters their Wiza credentials there. See Authorize a user for the full flow and statuses.

Tools

Pass the exact name to execute_tool
Try in PlaygroundRequest a tool
  • wiza_company_enrichmentLook up firmographic data for one company.Read-only

    Enrich Company

    Look up firmographic data for one company. Returns industry, size and size range, founding year, revenue range, funding, type, description, location, social links and domain. Use to enrich a known company; use wiza_prospect_search to find people at companies. Costs 2 API credits only when company data is found. Provide at least one of company_name, company_domain, company_linkedin_id or company_linkedin_slug.

    Inputs

    company_domainstring
    Domain of the company to enrich. At least one identifier field is required.
    company_linkedin_idstring
    LinkedIn company ID of the company to enrich. At least one identifier field is required.
    company_linkedin_slugstring
    LinkedIn company slug taken from the company page URL. At least one identifier field is required.
    company_namestring
    Name of the company to enrich. At least one of company_name, company_domain, company_linkedin_id or company_linkedin_slug is required.
  • wiza_get_creditsGet the remaining credit balances on the connected Wiza account.Read-only

    Get Credits

    Get the remaining credit balances on the connected Wiza account. Returns email credits, phone credits, export credits and API credits; email and phone credits may be the string 'unlimited'. Use this to check the balance before starting reveals or searches, which consume credits.

    Inputs

    This tool takes no inputs.

  • wiza_get_individual_revealGet the status and results of an individual reveal by its ID.Read-only

    Get Individual Reveal

    Get the status and results of an individual reveal by its ID. Returns status, is_complete, the person's name, title, location, emails with type and status, phone numbers, company details and remaining credits. Use after wiza_start_individual_reveal; repeat until is_complete is true or status is failed. Prerequisites: a reveal ID from wiza_start_individual_reveal.

    Inputs

    idstringrequired
    ID of the individual reveal, as returned by wiza_start_individual_reveal in data.id.
  • wiza_start_individual_revealStart an asynchronous reveal that finds the email and/or phone number of one person and returns the reveal ID.Write

    Start Individual Reveal

    Start an asynchronous reveal that finds the email and/or phone number of one person and returns the reveal ID. Returns the reveal id, its status (queued, resolving, finished or failed) and an is_complete flag; contact data is not included yet. Identify the person by LinkedIn profile_url, by full_name plus company or domain, or by email. Poll with wiza_get_individual_reveal until is_complete is true. Consumes credits according to enrichment_level.

    Inputs

    enrichment_levelstringrequired
    How much to look up. 'none' returns profile data for a LinkedIn URL or email without emails or phone numbers; 'partial' finds email; 'phone' finds phone numbers; 'full' finds email and phone numbers.one of nonepartialphonefull
    accept_personalboolean
    Set true to accept personal email addresses such as tcooke1960@gmail.com. If neither accept_work nor accept_personal is set, all email types are returned.
    accept_workboolean
    Set true to accept professional email addresses such as tim.cooke@apple.com. If neither accept_work nor accept_personal is set, all email types are returned.
    callback_urlstring
    URL that receives the reveal result when it completes. If omitted, the webhook URL from the Wiza account settings is used.
    companystring
    Company name of the person. Provide company or domain when identifying the person by full_name.
    domainstring
    Company domain of the person. Provide company or domain when identifying the person by full_name.
    emailstring
    Email address of the person. Can be used alone to identify the person.
    fair_keystring
    Key that spreads throughput fairly across sub-groups such as end users or lists. Reveals are dispatched round-robin across distinct values; if omitted, they run in submission order.
    full_namestring
    Full name of the person. Must be combined with either company or domain when no profile_url or email is given.
    profile_urlstring
    LinkedIn profile URL of the person. Use alone, or together with full_name and company/domain.