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
- Access token
Setup
Install the SDK
Terminal window npm install @scalekit-sdk/node dotenvTerminal window pip install scalekit-sdk-python python-dotenvSet your credentials
Add your Scalekit credentials to your
.envfile. 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>Create the Wiza connection
In AgentKit > Connections, create a Wiza connection. The name you give it is the
connection_nameyour code passes. See Configure connections.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.actionsconst connector = 'wiza'const identifier = 'user_123'// Generate an authorization link for the userconst { 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 callconst result = await actions.executeTool({connector,identifier,toolName: 'wiza_company_enrichment',toolInput: {},})console.log(result)Terminal window npx tsx quickstart.mtsquickstart.py import osfrom scalekit import ScalekitClientfrom dotenv import load_dotenvload_dotenv()scalekit_client = ScalekitClient(env_url=os.getenv("SCALEKIT_ENVIRONMENT_URL"),client_id=os.getenv("SCALEKIT_CLIENT_ID"),client_secret=os.getenv("SCALEKIT_CLIENT_SECRET"),)actions = scalekit_client.actionsconnection_name = "wiza"identifier = "user_123"# Generate an authorization link for the userlink_response = actions.get_authorization_link(connection_name=connection_name,identifier=identifier,)print("Authorize Wiza:", link_response.link)input("Press Enter after authorizing...")# Make your first callresult = actions.execute_tool(tool_input={},tool_name="wiza_company_enrichment",connection_name=connection_name,identifier=identifier,)print(result)Terminal window python quickstart.pyEach 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 toexecute_toolwiza_company_enrichmentLook up firmographic data for one company.Read-onlyEnrich 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-onlyGet 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-onlyGet 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_prospect_searchSearch Wiza's prospect database for people matching filters such as job title, seniority, location, company, industry, size, revenue and technologies.Read-onlySearch Prospects
Search Wiza's prospect database for people matching filters such as job title, seniority, location, company, industry, size, revenue and technologies. Returns data.total (matching count) and, when size is greater than 0, profiles with full name, LinkedIn URL, job title, role, company name and website, location, plus api_credits used. Use to find people before revealing contact details with wiza_start_individual_reveal. Use wiza_company_enrichment for a known company. At least one filter is required; size 0 returns only the count.
Inputs
additional_filtersobject- Extra Wiza prospect filters merged into the filters object for options not listed above, such as years_of_experience_min, years_of_experience_max, school, major, linkedin_slug, company_annual_growth, department_size, funding_date, funding_stage, funding_type, last_funding_min, last_funding_max, funding_min, funding_max, company_summary, year_founded_start and year_founded_end. Use the same field names and value formats as the Wiza Prospect Search API. Example: {"years_of_experience_min": 5, "funding_stage": {"t": "last", "v": ["series_a"]}}.
company_industryarray- Company industries. Each item has v (a valid Wiza industry value such as 'financial services') and optional s ('i' default, or 'e').
company_locationarray- Company locations. Each item has v, b (city, state, country, continent or group) and s ('i' or 'e').
company_sizearray- Company headcount ranges. Allowed values: 1-10, 11-50, 51-200, 201-500, 501-1000, 1001-5000, 5001-10000, 10001+.
company_typearray- Company types. Allowed values: private, public, educational, government, nonprofit, public_subsidiary.
first_namearray- Exact first names to match.
job_companyarray- Current company names to include or exclude. Each item has v (name) and s ('i' or 'e').
job_rolearray- Job roles. Allowed values: customer_service, design, education, engineering, finance, health, human_resources, legal, marketing, media, operations, public_relations, real_estate, sales, trades.
job_titlearray- Job titles to include or exclude. Each item has v (the title; wrap in double quotes inside the string for an exact match) and s ('i' include or 'e' exclude).
job_title_levelarray- Seniority levels. Allowed values: CXO, Director, Entry, Manager, Owner, Partner, Senior, Training, Unpaid, VP.
last_company_changestring- Only people who joined their current company within this period.one of
30d60d90d180d1y last_namearray- Exact last names to match.
last_role_changestring- Only people whose current role began within this period.one of
30d60d90d180d1y locationarray- Person locations. Each item has v (name: 'city, state, country', 'state, country' or 'country' depending on b), b (city, state, country, continent or group) and s ('i' or 'e').
past_companyarray- Past company names to include or exclude; people who currently work there also match. Each item has v and s ('i' or 'e').
revenuearray- Company revenue ranges. Allowed values: $0-$1M, $1M-$10M, $10M-$25M, $25M-$50M, $50M-$100M, $100M-$250M, $250M-$500M, $500M-$1B, $1B-$10B, $10B+.
sizeinteger- Number of profiles to return, 0 to 30. Wiza defaults to 0, which returns only the total count without profiles; set 1 to 30 to get profiles (billed in API credits).
skillarray- Skills the person must have.
technologiesarray- Technologies used by the company, as technology slugs. Each item has v (slug such as 'amazon-web-services') and optional s ('i' default, or 'e').
wiza_start_individual_revealStart an asynchronous reveal that finds the email and/or phone number of one person and returns the reveal ID.WriteStart 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.
No tools match.