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

hubspot-search-deals

Search HubSpot CRM deals by name or minimum amount via API scripts.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Finding specific deals in HubSpot CRM requires manual filtering through the web interface, which slows down sales workflows when you need quick lookups by deal name or deal value. ## Core Features & Use Cases - Name-Based Search: Find deals using partial name matching with the CONTAINS_TOKEN operator. - Amount Filtering: Filter deals by minimum amount using GTE comparison to surface high-value opportunities. - Structured JSON Output: Returns deal IDs, stages, amounts, close dates, and direct HubSpot URLs for immediate follow-up. - Use Case: A sales rep needs to check all open deals over $50,000 mentioning "Acme" before a pipeline review meeting, and gets a formatted list with stages and close dates in seconds. ## Quick Start Ask the AI to search HubSpot for deals matching a name like "Acme" with a minimum amount of 50000.

Frequently Asked Questions about hubspot-search-deals

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

FAQPage Schema
How do I search deals in HubSpot by name?▼

Run the search_deals.py script with the --name flag followed by your search term. It uses the CONTAINS_TOKEN operator for partial matching, so searching "Enterprise" finds all deals containing that word.

How to filter HubSpot deals by minimum amount?▼

Use the --min-amount flag with a numeric value, such as --min-amount 10000. The filter applies a GTE (greater than or equal) comparison, returning only deals at or above that value.

What HubSpot API scope is needed to search deals?▼

Searching deals requires the crm.objects.deals.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 deal search return a 401 or 429 error?▼

A 401 error means the access token is invalid and setup must be re-run. A 429 error indicates rate limiting, which resolves by waiting and retrying the request.

Can I combine name and amount filters in one HubSpot deal search?▼

Yes, pass both --name and --min-amount flags together along with --limit to control result count. Results are sorted by creation date with the newest deals first.

Related Skills

Explore More Marketing & Sales Skills→
beam-ai-teambeam-ai-team

hubspot-connect

Automate HubSpot CRM operations for contacts, companies, deals, and engagements.

Official
Advanced
Envision-ConstructionEnvision-Construction
1

Deal Lifecycle

Create, advance, and close deals in the Buildr CRM via MCP write actions.

Official
Intermediate
abdullahbeamabdullahbeam
2

hubspot-search-deals

Search HubSpot CRM deals by partial name and minimum amount filters.

Community
Intermediate
mentileadmentilead

positioning

Develop app positioning, ICP, and JTBD research for Shopify apps.

Official
Advanced