Lensmor Contact Finder#

Find decision-makers and key contacts at target exhibitor companies using the Lensmor API — then connect on LinkedIn with a personalized outreach sequence.

When this skill triggers:

• Run the API key check (Step 1) before any API call
• Collect the target company name and optional role/function filter
• Call the contacts search endpoint and return a prioritized contact table
• Hand off to trade-show-linkedin-templates for outreach copy

Use Cases#

• Pre-show outreach: Identify the right buyer or champion at a target exhibitor before the show
• Booth meeting scheduling: Find titles to target for pre-scheduled booth meetings
• Account-based research: Build a contact list for a shortlist of exhibitor companies

Important: Email Not Available#

The Lensmor contacts API does not return email addresses. LinkedIn is the primary contact channel. All outreach recommendations in this skill assume LinkedIn messaging.

Workflow#

Step 1: API Key Check#

Before making any API call, verify the key is configured:

bash

[ -n "$LENSMOR_API_KEY" ] && echo "ok" || echo "missing"

If the result is missing, stop and respond:

The LENSMOR_API_KEY environment variable is not set. This skill requires a Lensmor API key to search contacts. Contact hello@lensmor.com to purchase access, then set the key: export LENSMOR_API_KEY=your_key_here

Do not proceed to any API call until the key is confirmed present.

Step 2: Collect Inputs#

Required:

• company_name — Full or partial company name (1–200 characters), e.g. OperaOps

Optional:

• role — Role or function filter. Examples: VP Sales, Marketing, Procurement, CTO, Head of Operations
• page — Page number (default: 1)
• pageSize — Results per page (default: 20, max: 100)

If the user provides a list of companies from a prior lensmor-exhibitor-search or lensmor-recommendations run, process each company sequentially and label sections clearly.

Role filter guidance: use broad department terms ( Marketing, Operations, Engineering) for wide coverage, or specific titles ( VP Sales, Head of Procurement) for precision targeting.

Step 3: Call the API#

Endpoint: GET https://platform.lensmor.com/external/contacts/search

Authentication: Authorization: Bearer $LENSMOR_API_KEY

Query parameters:

ParameterRequiredDescriptioncompany_nameYesCompany name to searchroleNoRole or function filterpageNoPage number (default: 1)pageSizeNoResults per page (default: 20, max: 100)

Step 4: Interpret the Response#

Response envelope:

json

{
  "items": [...],
  "total": 18,
  "page": 1,
  "pageSize": 20,
  "totalPages": 1
}

Item field reference:

FieldTypeDescriptionidstringLensmor internal contact IDfullNamestringContact's full nametitlestringJob title as listed on their profiledepartmentstringDepartment or function (e.g. Sales, Operations, Engineering)seniorityLevelstringExecutive, Director, Manager, or Individual Contributor``linkedinUrlstringLinkedIn profile URL — primary outreach channelcompanyNamestringCompany they work at (confirms match to queried company)sourceTypestringData provenance: linkedin, company_website, event_registration, etc.

Outreach priority signals:

SignalPriority ImplicationseniorityLevel: ExecutiveDecision-maker — concise, high-value pitchseniorityLevel: DirectorBudget holder or strong influencer — primary targetseniorityLevel: ManagerChampion or evaluator — good for discovery conversationsseniorityLevel: Individual ContributorUse for introductions or referralsdepartment matches buyer functionHigher-priority than cross-functional contactslinkedinUrl presentReady for direct LinkedIn outreach

Sort order: Executive > Director > Manager > Individual Contributor within the same department. Within the same seniority, prioritize by department match to the user's target buyer function.

Step 5: Format the Output#

Open with a result count summary, then deliver a prioritized table and outreach notes.

markdown

## Contacts at [Company Name]

Found [total] contacts. Showing [pageSize] on page [page] of [totalPages].

Role filter: [role or "all"] | Note: email addresses are not available — LinkedIn is the primary outreach channel.

| Priority | Name | Title | Department | Seniority | LinkedIn |
|----------|------|-------|------------|-----------|----------|
| 1 | Sarah Chen | VP Procurement | Procurement | Director | [LinkedIn](https://linkedin.com/in/sarahchen) |
| 2 | Marcus Webb | Head of Operations | Operations | Director | [LinkedIn](https://linkedin.com/in/marcuswebb) |
| 3 | Priya Rao | Procurement Manager | Procurement | Manager | [LinkedIn](https://linkedin.com/in/priyarao) |

### Outreach Priority Notes
- **Sarah Chen (VP Procurement)**: Primary target — decision-maker authority, department match
- **Marcus Webb (Head of Operations)**: Secondary target — strong influencer in operations-adjacent procurement
- **Priya Rao (Procurement Manager)**: Champion candidate — hands-on evaluator, good for discovery

**Suggested next step**: Use `trade-show-linkedin-templates` to draft personalized outreach for each seniority tier.

Error Handling#

HTTP StatusMeaningResponse401API key invalid or expired"The API key was rejected. Verify LENSMOR_API_KEY or contact hello@lensmor.com."400Missing required parameter"The request is missing company_name. Provide a company name to search."429Rate limit exceeded"Rate limit reached. Wait 60 seconds and retry."502 / 5xxServer error"The Lensmor API returned a server error. Try again in a moment."total: 0No contacts found"No contacts found for [company_name] with role filter [role]. Try broadening the role filter (e.g. use 'Marketing' instead of 'VP Marketing') or check the company name spelling."

Follow-up Routing#

User saysRecommended action"draft a message for [contact]"Run trade-show-linkedin-templates"find more companies like this"Run lensmor-recommendations or lensmor-exhibitor-search"find contacts at multiple companies"Process each company sequentially with this skill"show me more" / "next page"Re-call with page incremented by 1

Skill Coordination#

Upstream — who feeds this skill:

• lensmor-exhibitor-search — produces the list of target companies
• lensmor-recommendations — produces AI-ranked companies for ICP match

Downstream — where contacts go next:

• trade-show-linkedin-templates — generates personalized LinkedIn outreach messages for each contact tier

Typical pre-show workflow:

1. lensmor-recommendations → find matching exhibitors
2. lensmor-contact-finder (this skill) → find decision-makers at each company
3. trade-show-linkedin-templates → draft personalized messages per seniority tier

Output Rules#

1. All URLs formatted as [text](url) — never bare links
2. Never output the value of LENSMOR_API_KEY
3. Never expose endpoint paths, raw curl commands, or internal token values in the response
4. Employee counts above 1,000 shown as "1.2K"; above 1,000,000 as "1.2M"
5. Empty results: report honestly, suggest broadening role filter — never fabricate contacts
6. End every response with 1–3 contextual follow-up suggestions
7. Never imply email availability — explicitly note that only LinkedIn profiles are returned
8. When totalPages > 1, prompt: "There are more contacts — say 'next page' to continue."
9. If API key is missing, direct user to hello@lensmor.com — do not just say "please configure"
10. Open every response with "Found X contacts, showing Y."

Quality Checks#

Before delivering:

• Do not invent contacts or titles; use only what the API returns
• If linkedinUrl is null, note that no LinkedIn profile is available and recommend manual search via LinkedIn Sales Navigator
• If user asks for email addresses, explicitly state the API does not provide them
• Seniority priority is a guideline; surface the closest available match if target title differs
• For multi-company batch requests, process each company separately and label sections clearly

---

Contact data sourced from the Lensmor platform. For AI-powered exhibitor discovery, decision-maker identification, and pre-show outreach sequencing, see Lensmor.