skills.rest
FahadImdad
FahadImdadCOMMUNITY
Explore all skills by this author →
GitHub

hubspot-search-contacts

Search HubSpot CRM contacts by email, name, or company via API scripts.

Updated Jan 22, 2026
Search Tags:#api#sales#crm#hubspot#contact search#lead lookup
One-click install
npx skills add https://github.com/FahadImdad/Nexus-Fahad --skill hubspot-search-contacts-fahadimdad
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: hubspot-search-contacts
Source: https://github.com/FahadImdad/Nexus-Fahad/tree/main/00-system/skills/hubspot/hubspot-search-contacts
Command: npx skills add https://github.com/FahadImdad/Nexus-Fahad --skill hubspot-search-contacts-fahadimdad

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Finding specific contacts in a large HubSpot CRM database manually is slow and error-prone. This Skill lets you search contacts programmatically by email, name, or company and get structured JSON results instantly. ## Core Features & Use Cases - Multi-Criteria Search: Search contacts by email (exact match), name (partial match), or company (partial match), with filters combined using AND logic. - Structured JSON Output: Returns contact IDs, properties, and HubSpot URLs in a consistent format ready for display or downstream processing. - Pre-Flight Config Check: Validates HubSpot connection and credentials before executing searches, with clear error guidance for 401, 403, and 429 responses. - Use Case: A sales rep needs to find all contacts named John at Acme Corp before a call. Run a combined name and company search to retrieve matching records with emails and IDs in seconds. ## Quick Start Ask the AI to search HubSpot contacts for a person named John at Acme and show the matching results.

Frequently Asked Questions about hubspot-search-contacts

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I search contacts in HubSpot by email?▼

Run the search_contacts.py script with the --email flag followed by the address. Email search uses the EQ operator for exact matching, so the full address must match the stored record precisely.

How to search HubSpot contacts by name or company?▼

Use the --name or --company flags with the search script. Both use the CONTAINS_TOKEN operator for partial matching, and you can combine them with --limit to narrow results using AND logic.

What HubSpot API scope is needed to search contacts?▼

Searching contacts requires the crm.objects.contacts.read scope on your HubSpot private app token. A 403 error indicates this scope is missing and the token must be regenerated with the correct permissions.

Why does HubSpot contact search return a 401 error?▼

A 401 error means the API token is invalid or expired. Re-run the HubSpot setup flow to generate a new private app token and update your configuration before retrying the search.

What happens when HubSpot API rate limits are hit?▼

The API returns a 429 error when rate limits are exceeded. Wait for the rate limit window to reset and retry the request, or reduce search frequency and result limits.

Related Skills

Explore More Marketing & Sales Skills→
abdullahbeamabdullahbeam
2

hubspot-connect

Automate HubSpot CRM contact, company, deal, and engagement management operations.

Community
Advanced
wyre-technologywyre-technology
39

HubSpot Contacts

Manages, searches, and updates contact records in HubSpot CRM.

Official
Intermediate
openaiopenai
488

enrich-company-and-contact-data

Enrich company and contact records with firmographic and technographic data.

Official
Advanced
abdullahbeamabdullahbeam
2

hubspot-search-contacts

Search HubSpot CRM contacts by email, name, or company filters.

Community
Intermediate