Use cases and templates: Wiza integration for AI agents
Use Wiza to search prospects, enrich companies, reveal contact details, and check credits. Individual Reveal starts enrichment and polls within one block operation; it fails if the polling window ends before completion.
Use the block
Set up the Wiza API key
- Sign in to your Wiza account.
- Open Settings → API and create a key, or copy an existing one.
- Paste it into the block's Wiza API Key field.
The key is used for each operation. Wiza's rate-limit guide currently lists Individual Reveal at 15 requests per second. Limits vary by endpoint; reduce request frequency after a 429 response.
Individual Reveal
Select Individual Reveal and supply a LinkedIn URL, a name plus company/domain, or an email. The operation starts enrichment and polls at two-second intervals for up to 60 attempts. It returns contact data, status, and is_complete when a terminal result arrives. No separate polling block or callback URL is required.
An incomplete reveal after that polling window fails the block. Three consecutive failed HTTP polling responses also fail it. Wiza may continue processing an already-started reveal; inspect the reveal in Wiza before submitting it again.
Enrichment levels and credits
| Level | Requested data | Provider credit use |
|---|---|---|
none | Profile and company data; no contact details | 1 credit for a matched LinkedIn profile |
partial | Emails, with work/personal acceptance controls | 2 credits when a valid email is returned |
phone | Phone numbers | 5 credits when a phone is returned |
full | Emails and phones | Applicable email and phone charges |
Check wiza_get_credits before large batches and inspect the response's credits object. Wiza documents deductions when data is found; see its API guide for current credit rules. Sim-provided API keys have their own metering; distinguish that charge from the provider balance on a key you supply.
Search prospects, enrich companies, reveal verified emails and phone numbers for individuals, and check your account credit balance.
Actions
Wiza Prospect Search
Search Wiza's database of prospects using person, company, and financial filters
Input
| Parameter | Type | Required | Description |
|---|---|---|---|
apiKey | string | Yes | Wiza API key |
size | number | No | Number of sample profiles to return (0-30, default 0) |
filters | object | No | Full filters object (overrides individual filter params if provided) |
first_name | array | No | Exact first names to match (e.g., ["John", "Jane"]) |
last_name | array | No | Exact last names to match |
job_title | array | No | Job titles to include/exclude (e.g., [{"v":"CEO","s":"i"},{"v":"CTO","s":"e"}]) |
job_title_level | array | No | Seniority levels (e.g., ["cxo", "director", "manager"]) |
job_role | array | No | Job role categories (e.g., ["sales", "engineering", "marketing"]) |
job_sub_role | array | No | Detailed role categories (e.g., ["software", "product"]) |
location | array | No | Person's location filters (city/state/country with include/exclude) |
skill | array | No | Professional skills (e.g., ["python", "marketing"]) |
school | array | No | Educational institutions |
major | array | No | Field of study |
linkedin_slug | array | No | LinkedIn profile slugs |
job_company | array | No | Current company filters (include/exclude) |
past_company | array | No | Past company filters |
company_location | array | No | Company HQ location filters |
company_industry | array | No | Company industry filters (include/exclude) |
company_size | array | No | Company headcount brackets (e.g., ["1-10", "11-50", "51-200"]) |
company_type | array | No | Company type (e.g., ["private", "public", "educational"]) |
Output
| Parameter | Type | Description |
|---|---|---|
total | number | Total number of matching prospects |
profiles | array | Sample profiles matching the filter criteria |
Wiza Company Enrichment
Enrich a company by name, domain, LinkedIn ID, or LinkedIn slug with detailed firmographic data
Input
| Parameter | Type | Required | Description |
|---|---|---|---|
apiKey | string | Yes | Wiza API key |
company_name | string | No | Company name (e.g., "Wiza") |
company_domain | string | No | Company domain (e.g., "wiza.co") |
company_linkedin_id | string | No | Company LinkedIn ID |
company_linkedin_slug | string | No | Company LinkedIn slug from the URL |
Output
| Parameter | Type | Description |
|---|---|---|
company_name | string | Company name |
company_domain | string | Company domain |
domain | string | Domain |
company_industry | string | Industry |
company_size | number | Employee count |
company_size_range | string | Headcount range |
company_founded | number | Year founded |
company_revenue_range | string | Revenue range |
company_funding | string | Total funding |
company_type | string | Company type |
company_description | string | Description |
company_ticker | string | Stock ticker |
company_last_funding_round | string | Last funding round |
company_last_funding_amount | string | Last funding amount |
company_last_funding_at | string | Last funding date |
company_location | string | Full location string |
company_twitter | string | Twitter URL |
company_facebook | string | Facebook URL |
company_linkedin | string | LinkedIn URL |
company_linkedin_id | string | LinkedIn ID |
company_street | string | Street address |
company_locality | string | City |
company_region | string | State/region |
company_postal_code | string | Postal code |
company_country | string | Country |
credits | json | Credits deducted for this enrichment (api_credits: { total, company_credits }) |
Wiza Individual Reveal
Reveal a contact by LinkedIn URL, name plus company/domain, or email. Starts the reveal and polls at two-second intervals for up to 60 attempts, failing if it remains incomplete. Wiza charges 2 credits for a valid email, 5 for a phone, or 1 for a matched profile-only reveal.
Input
| Parameter | Type | Required | Description |
|---|---|---|---|
apiKey | string | Yes | Wiza API key |
enrichment_level | string | Yes | Enrichment depth: none, partial, phone, or full |
profile_url | string | No | LinkedIn profile URL (e.g., https://linkedin.com/in/johndoe) |
full_name | string | No | Full name (used with company or domain) |
company | string | No | Company name (used with full_name) |
domain | string | No | Company domain (used with full_name) |
email | string | No | Email address (use alone or with other identifiers) |
accept_work | boolean | No | Whether to accept work emails (email_options) |
accept_personal | boolean | No | Whether to accept personal emails (email_options) |
Output
| Parameter | Type | Description |
|---|---|---|
id | number | Reveal ID |
status | string | queued | resolving | finished | failed |
is_complete | boolean | Whether the reveal has completed |
name | string | Full name |
company | string | Company name |
enrichment_level | string | Enrichment level used |
linkedin_profile_url | string | LinkedIn URL |
title | string | Job title |
location | string | Location |
email | string | Primary email |
email_type | string | Email type |
email_status | string | valid | risky | unfound |
emails | array | All emails found |
mobile_phone | string | Mobile phone |
phone_number | string | Direct/office phone |
phone_status | string | found | unfound |
phones | array | All phones found |
company_size | number | Employee count |
company_size_range | string | Headcount range |
company_type | string | Company type |
company_domain | string | Company domain |
company_locality | string | City |
company_region | string | State/region |
company_country | string | Country |
company_street | string | Street |
company_postal_code | string | Postal code |
company_founded | number | Year founded |
company_funding | string | Funding total |
company_revenue | string | Revenue |
company_industry | string | Industry |
company_subindustry | string | Subindustry |
company_linkedin | string | Company LinkedIn URL |
company_location | string | Full company location |
company_description | string | Company description |
credits | json | Credits consumed by the reveal |
Wiza Get Credits
Retrieve the remaining credits on your Wiza account
Input
| Parameter | Type | Required | Description |
|---|---|---|---|
apiKey | string | Yes | Wiza API key |
Output
| Parameter | Type | Description |
|---|---|---|
email_credits | json | Remaining email credits (number or "unlimited") |
phone_credits | json | Remaining phone credits (number or "unlimited") |
export_credits | number | Remaining export credits |
api_credits | number | Remaining API credits |