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:

CODEBLOCK0

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:
INLINECODE3

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. INLINECODE5

Optional:

• - role — Role or function filter. Examples: VP Sales, Marketing, Procurement, CTO, INLINECODE11
• INLINECODE12 — Page number (default: 1)
• INLINECODE13 — 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: INLINECODE21

Authentication: INLINECODE22

Query parameters:

Parameter	Required	Description
INLINECODE23	Yes	Company name to search
INLINECODE24

No | Role or function filter |
| page | No | Page number (default: 1) |
| pageSize | No | Results per page (default: 20, max: 100) |

Step 4: Interpret the Response

Response envelope:

CODEBLOCK1

Item field reference:

Field	Type	Description
INLINECODE27	string	Lensmor internal contact ID
INLINECODE28

string | Contact's full name |
| title | string | Job title as listed on their profile |
| department | string | Department or function (e.g. Sales, Operations, Engineering) |
| seniorityLevel | string | Executive, Director, Manager, or Individual Contributor |
| linkedinUrl | string | LinkedIn profile URL — primary outreach channel |
| companyName | string | Company they work at (confirms match to queried company) |
| sourceType | string | Data provenance: linkedin, company_website, event_registration, etc. |

Outreach priority signals:

Signal	Priority Implication
INLINECODE45	Decision-maker — concise, high-value pitch
INLINECODE46

Budget holder or strong influencer — primary target |
| seniorityLevel: Manager | Champion or evaluator — good for discovery conversations |
| seniorityLevel: Individual Contributor | Use for introductions or referrals |
| department matches buyer function | Higher-priority than cross-functional contacts |
| linkedinUrl present | Ready 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.

CODEBLOCK2

Error Handling

HTTP Status	Meaning	Response
401	API key invalid or expired	"The API key was rejected. Verify LENSMOR_API_KEY or contact hello@lensmor.com."
400

Missing required parameter | "The request is missing company_name. Provide a company name to search." | | 429 | Rate limit exceeded | "Rate limit reached. Wait 60 seconds and retry." | | 502 / 5xx | Server error | "The Lensmor API returned a server error. Try again in a moment." | | total: 0 | No 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 says	Recommended action
"draft a message for [contact]"	Run INLINECODE61
"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
• INLINECODE66 — 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. 1. lensmor-recommendations → find matching exhibitors
2. INLINECODE69 (this skill) → find decision-makers at each company
3. INLINECODE70 → draft personalized messages per seniority tier

Output Rules

1. 1. All URLs formatted as [text](url) — never bare links
2. Never output the value of INLINECODE72
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.