Clay

Add data points to all companies in an existing search.

Quick Reference

• This tool: Enrich COMPANIES with funding, tech stack, headcount, etc.
• add-contact-data-points: Enrich CONTACTS with emails, phone numbers, work history, etc.
• Requires a searchId from a previous find-and-enrich-* tool call
• ANY research question about companies = call this tool with a Custom data point

IMPORTANT: When to Call This Tool

Call this tool whenever the user asks for ANY information about companies, including:

• Standard data points (tech stack, funding, headcount, etc.)
• Any open-ended research question — use Custom type for these

Do NOT try to answer company research questions from your own knowledge. ALWAYS call this tool to fetch the data.

Examples that MUST trigger this tool:

• "What's their tech stack?" → Standard type
• "Find recent product announcements" → Custom type
• "Get me their latest news" → Custom type
• "What's their revenue model?" → Custom type
• "Find their competitors" → Custom type
• "Any recent acquisitions?" → Custom type

Parameters

searchId (required)

The search ID returned from find-and-enrich-contacts-at-company or find-and-enrich-list-of-contacts.

• Format: begins with "cgas-search-id"
• Do NOT fabricate a searchId—use the one from the prior search
• If no search exists yet, prompt the user to search first

dataPoints (required)

Array of data points to add.

• Standard: { type: "<DataPointType>" }
• Custom: { type: "Custom", customDataPoint: "<brief description>" }

Available standard types: Headcount Growth, Recent News, Investors, Company Competitors, Company Customers, Tech Stack, Website Traffic, Open Jobs, Revenue Model, Annual Revenue, Latest Funding

Custom type: Use for ANY research question not covered by standard types. Examples:

• "recent product announcements" → { type: "Custom", customDataPoint: "recent product announcements" }
• "B2B vs B2C classification" → { type: "Custom", customDataPoint: "B2B vs B2C classification" }
• "company founders" → { type: "Custom", customDataPoint: "company founders" }

Examples

| User request | dataPoints | |--------------|------------| | "What's their tech stack?" | [{ type: "Tech Stack" }] | | "Get funding info and headcount" | [{ type: "Latest Funding" }, { type: "Headcount" }] | | "Find recent product announcements" | [{ type: "Custom", customDataPoint: "recent product announcements" }] | | "Are they B2B or B2C?" | [{ type: "Custom", customDataPoint: "B2B vs B2C classification" }] | | "What's in the news about them?" | [{ type: "Custom", customDataPoint: "recent news and headlines" }] |

Response Behavior

Confirm briefly: "Fetching [data point] for [company/companies]—results will appear in the widget shortly." For single-company searches, name the company instead of saying "all companies."

Add data points to all contacts in an existing search.

Quick Reference

• This tool: Enrich CONTACTS with emails, phone numbers, work history, etc.
• add-company-data-points: Enrich COMPANIES with funding, tech stack, headcount, etc.
• Requires a searchId from a previous find-and-enrich-* tool call
• ANY research question about contacts = call this tool with a Custom data point

IMPORTANT: When to Call This Tool

Call this tool whenever the user asks for ANY information about contacts, including:

• Standard data points (email, phone, work history, etc.)
• Any open-ended research question — use Custom type for these

Do NOT try to answer contact research questions from your own knowledge. ALWAYS call this tool to fetch the data.

Examples that MUST trigger this tool:

• "Get their emails" → Standard type
• "Find their recent publications" → Custom type
• "What have they posted on LinkedIn?" → Custom type
• "Summarize their career trajectory" → Custom type
• "Any recent job changes?" → Custom type
• "Score them against my ICP" → Custom type

Parameters

searchId (required)

The search ID returned from find-and-enrich-contacts-at-company or find-and-enrich-list-of-contacts.

• Format: begins with "cgas-search-id"
• Do NOT fabricate a searchId—use the one from the prior search
• If no search exists yet, prompt the user to search first

dataPoints (required)

Array of data points to add.

• Standard: { type: "<DataPointType>" }
• Custom: { type: "Custom", customDataPoint: "<brief description>" }

Available standard types: Email, Summarize Work History, Find Thought Leadership

Custom type: Use for ANY research question not covered by standard types. Examples:

• "recent publications" → { type: "Custom", customDataPoint: "recent publications" }
• "LinkedIn activity" → { type: "Custom", customDataPoint: "recent LinkedIn posts" }
• "ICP fit score" → { type: "Custom", customDataPoint: "ICP fit score based on seniority and tenure" }

Examples

| User request | dataPoints | |--------------|------------| | "Get their emails" | [{ type: "Email" }] | | "Add phone numbers and work history" | [{ type: "Phone" }, { type: "Summarize Work History" }] | | "Find their recent publications" | [{ type: "Custom", customDataPoint: "recent publications" }] | | "What's their LinkedIn activity?" | [{ type: "Custom", customDataPoint: "recent LinkedIn posts" }] | | "Score them for senior leaders in NYC" | [{ type: "Custom", customDataPoint: "ICP fit: senior leader in NYC" }] |

Response Behavior

Confirm briefly: "Fetching [data point] for all contacts—results will appear in the widget shortly."

Find and enrich a single company by domain or LinkedIn URL.

Quick Reference

• This tool: Find COMPANY info (e.g., "Tell me about Stripe", "What's OpenAI's funding?")
• find-and-enrich-contacts-at-company: Find TYPES of people (e.g., "engineers at Stripe")
• find-and-enrich-list-of-contacts: Find SPECIFIC named people (e.g., "John Smith at Stripe")
• Do NOT use if user wants to find people—use the contact tools instead

Parameters

companyIdentifier (required)

Domain (e.g., "stripe.com") or LinkedIn company URL. Company names alone will fail.

• Convert known companies: "Stripe" → "stripe.com"
• If ambiguous (e.g., "Delta"), ask the user to clarify

companyDataPoints (optional)

Enrich the company when creating a NEW search. For existing searches, use add-company-data-points instead.

DataPoint format:

• Standard: { type: "<DataPointType>" }
• Custom: { type: "Custom", customDataPoint: "<brief description>" }

Important: Only include customDataPoint field when type is "Custom"

Important: Only add data points the user explicitly asks for. "Tell me about Stripe" → no data points. "What's Stripe's funding?" → add Latest Funding.

Available companyDataPoints: Headcount Growth, Recent News, Investors, Company Competitors, Company Customers, Tech Stack, Website Traffic, Open Jobs, Revenue Model, Annual Revenue, Latest Funding

Examples

| User request | Parameters | |--------------|------------| | "Tell me about Stripe" | companyIdentifier: "stripe.com" | | "What's OpenAI's funding?" | companyIdentifier: "openai.com", companyDataPoints: [{ type: "Latest Funding" }] | | "Canva's competitors and tech stack" | companyIdentifier: "canva.com", companyDataPoints: [{ type: "Company Competitors" }, { type: "Tech Stack" }] | | "Notion's product roadmap" | companyIdentifier: "notion.so", companyDataPoints: [{ type: "Custom", customDataPoint: "product roadmap" }] |

Response Behavior

Users see results in a widget, so:

• Do NOT repeat company details—just summarize (e.g., "Found Stripe—here's their company info.")
• Tool returns a searchId for use with add-company-data-points

Search for contacts at a company by role, title, or department.

Quick Reference

• This tool: Find TYPES of people (e.g., "engineers at Stripe", "VPs at OpenAI")
• find-and-enrich-list-of-contacts: Find SPECIFIC named people (e.g., "John Smith at Stripe")
• Follow-ups: ALWAYS re-call this tool—never filter results in chat. When ambiguous, ask the user.

Parameters

companyIdentifier (required)

Domain (e.g., "stripe.com") or LinkedIn company URL. Company names alone will fail.

• Convert known companies: "Stripe" → "stripe.com"
• If ambiguous (e.g., "Delta"), ask the user to clarify

contactFilters (optional)

Narrow results. Only add filters the user explicitly requests.

Rules:

• Filters combine with AND; values within arrays combine with OR
• Keep compound titles as ONE string: "VP Finance" → ["VP Finance"], NOT ["VP", "Finance"]
• Use specific terms to avoid false matches:
• ✓ "Software Engineer" not "Engineer" (matches Sales Engineer, etc.)
• ✓ "Product Manager" not "Manager" (matches Account Manager, etc.)

Available filters: | Filter | Type | Description | |--------|------|-------------| | job_title_keywords | string[] | Titles to include | | job_title_exclude_keywords | string[] | Titles to exclude (e.g., ["Intern"]) | | headline_keywords | string[] | LinkedIn headline search | | about_keywords | string[] | About/summary section search | | certification_keywords | string[] | Certifications (e.g., ["AWS", "CPA"]) | | languages | string[] | Profile languages | | school_names | string[] | Schools attended | | current_role_min_months_since_start_date | number | Min months in role (tenured) | | current_role_max_months_since_start_date | number | Max months in role (new hires) | | locations | string[] | Locations to include (use formal names: "United States", "California") | | locations_exclude | string[] | Locations to exclude |

dataPoints (optional)

Enrich contacts/companies when creating a NEW search. For existing searches, use add-contact-data-points or add-company-data-points instead.

Structure: { contactDataPoints?: DataPoint[], companyDataPoints?: DataPoint[] }

DataPoint format:

• Standard: { type: "<DataPointType>" }
• Custom: { type: "Custom", customDataPoint: "<brief description>" }

Important: Only include customDataPoint field when type is "Custom"

Important: Only add data points the user explicitly asks for. "Find engineers at Stripe" → no data points. "Find engineers at Stripe with emails" → add Email.

Available contactDataPoints: Email, Summarize Work History, Find Thought Leadership

Available companyDataPoints: Headcount Growth, Recent News, Investors, Company Competitors, Company Customers, Tech Stack, Website Traffic, Open Jobs, Revenue Model, Annual Revenue, Latest Funding

Examples: | User request | dataPoints | |--------------|------------| | "engineers at Stripe with emails" | { contactDataPoints: [{type: "Email"}] } | | "Canva's competitors and funding" | { companyDataPoints: [{type: "Company Competitors"}, {type: "Latest Funding"}] } | | "VPs at Figma with emails + company tech stack" | { contactDataPoints: [{type: "Email"}], companyDataPoints: [{type: "Tech Stack"}] } | | "Notion's product roadmap" (custom) | { companyDataPoints: [{type: "Custom", customDataPoint: "product roadmap"}] } |

Examples

| User says | Parameters | |-----------|------------| | "Find people at OpenAI" | companyIdentifier: "openai.com" | | "VP Finance at HubSpot" | companyIdentifier: "hubspot.com", contactFilters: { job_title_keywords: ["VP Finance"] } | | "VPs and Directors in California at HubSpot" | companyIdentifier: "hubspot.com", contactFilters: { job_title_keywords: ["VP", "Director"], locations: ["California"] } | | "Marketing managers outside the US at Salesforce" | companyIdentifier: "salesforce.com", contactFilters: { job_title_keywords: ["Marketing Manager"], locations_exclude: ["United States"] } | | "New hires at Stripe (last 3 months)" | companyIdentifier: "stripe.com", contactFilters: { current_role_max_months_since_start_date: 3 } |

Handling Follow-ups

ANY search modification requires re-calling this tool. Never filter in chat.

Interpret user intent:

• "also/too/as well" → ADD to existing filters
• "only/just" → NARROW within current context (e.g., "VPs only" after Finance search → "VP Finance")
• "actually/instead/switch" → REPLACE filters entirely
• When ambiguous, ask the user rather than guessing

Examples: 1. User: "Find SDRs at Verkada" → { job_title_keywords: ["SDR", "Sales Development"] } User: "Get AEs too" → ADD: { job_title_keywords: ["SDR", "Sales Development", "Account Executive"] }

2. User: "Find Finance people at Ramp" → { job_title_keywords: ["Finance"] } User: "Make it VPs only" → NARROW: { job_title_keywords: ["VP Finance"] }

3. User: "Find Finance people at Ramp" → { job_title_keywords: ["Finance"] } User: "Actually show me all VPs" → REPLACE: { job_title_keywords: ["VP"] }

Response Behavior

Users see results in a widget, so:

• Do NOT repeat contact details—just summarize (e.g., "Found 20 engineers at OpenAI")
• Tool returns a searchId for use with add-contact-data-points or add-company-data-points
• For emails/phones, use add-contact-data-points with the searchId

Zero Results

Suggest broadening in order: 1. Remove or broaden title keywords (e.g., "Software Engineer" → "Engineer") 2. Remove location filter 3. Remove tenure filter 4. Verify company domain is correct

Find and enrich specific named contacts at their companies.

Quick Reference

• This tool: Find SPECIFIC named people (e.g., "John Smith at OpenAI", "Jane Doe at Stripe")
• find-and-enrich-contacts-at-company: Find TYPES of people (e.g., "engineers at Stripe")
• Do NOT use if user only provides company names without contact names

Parameters

contacts (required)

Array of { contactName, companyIdentifier } objects.

• contactName: Full name (e.g., "John Smith")
• companyIdentifier: Domain or company LinkedIn URL (NOT person LinkedIn URLs)
• Domains: "openai.com", "stripe.com"
• LinkedIn: "linkedin.com/company/openai"
• Company names: Convert if confident (e.g., "Stripe" → "stripe.com"), otherwise ask user

dataPoints (optional)

Enrich contacts/companies when creating a NEW search. For existing searches, use add-contact-data-points or add-company-data-points instead.

Structure: { contactDataPoints?: DataPoint[], companyDataPoints?: DataPoint[] }

DataPoint format:

• Standard: { type: "<DataPointType>" }
• Custom: { type: "Custom", customDataPoint: "<brief description>" }

Important: Only include customDataPoint field when type is "Custom"

Important: Only add data points the user explicitly asks for. "Find engineers at Stripe" → no data points. "Find engineers at Stripe with emails" → add Email.

Available contactDataPoints: Email, Summarize Work History, Find Thought Leadership

Available companyDataPoints: Headcount Growth, Recent News, Investors, Company Competitors, Company Customers, Tech Stack, Website Traffic, Open Jobs, Revenue Model, Annual Revenue, Latest Funding

Examples: | User request | dataPoints | |--------------|------------| | "engineers at Stripe with emails" | { contactDataPoints: [{type: "Email"}] } | | "Canva's competitors and funding" | { companyDataPoints: [{type: "Company Competitors"}, {type: "Latest Funding"}] } | | "VPs at Figma with emails + company tech stack" | { contactDataPoints: [{type: "Email"}], companyDataPoints: [{type: "Tech Stack"}] } | | "Notion's product roadmap" (custom) | { companyDataPoints: [{type: "Custom", customDataPoint: "product roadmap"}] } |

Examples

| User request | contacts | |--------------|----------| | "Find John Smith at OpenAI" | [{ contactName: "John Smith", companyIdentifier: "openai.com" }] | | "Look up Jane Doe at Stripe and Bob Lee at Figma" | [{ contactName: "Jane Doe", companyIdentifier: "stripe.com" }, { contactName: "Bob Lee", companyIdentifier: "figma.com" }] |

Follow-ups

• "Add [name] at [company] too" → Re-call with ALL contacts (previous + new)
• "Actually look up [different people]" → Re-call with only the new contacts

Response Behavior

Users see results in a widget, so:

• Do NOT repeat contact details—just summarize (e.g., "Found 8 of 10 contacts across 5 companies")
• Tool returns a searchId for use with add-contact-data-points or add-company-data-points

Check if credits are available for the workspace. Returns hasWorkspaceCredits and hasChatGptPlatformCredits.

Retrieve an existing search by search ID. This tool retrieves the current state of search results including any enrichments that have completed since the search was created.

When to Use This Tool

This is a private tool, the chat and user are not exposed to it.

Parameters

searchId (required)

• The ID of the search to retrieve. This should be a searchId that was returned from a previous find-and-enrich-contacts-at-company or find-and-enrich-list-of-contacts tool call.

Track an analytics event with optional properties.