You've got a CSV of leads or company data and need to push it into HubSpot without writing a script that searches, checks for existence, then creates or updates. This wraps the `hubspot objects upsert` CLI around a jq pipeline so you can match contacts by email or companies by domain in one pass per record. The dry run workflow is solid, the per-record JSON output lets you split successes from failures and retry just what broke, and it actually tells you about the five filter limit on OR searches instead of letting you discover it at 2am. If you're doing any kind of bulk CRM sync from external data, this is the pattern. Just lowercase your keys first.

skills.sh installs
1.8K
GitHub stars
29
last updated
Aug 21, 2026

Install

$ npx -y skills add hubspot/agent-cli-skills --skill data-enrichment --agent claude-code

Installs into .claude/skills of the current project.

Files

Prereq: read bulk-operations/SKILL.md first — JSONL piping, dry-run/digest, history, and rate-limit hygiene live there. This skill is the upsert-by-natural-key workflow on top.

The core move: upsert, not search-then-create

hubspot objects upsert --type X --id-property <natural-key> reads JSONL on stdin and creates-or-updates each row in one CLI call (the CLI batches 100 rows per API request), keyed by a property (email for contacts, domain for companies). No race window, no branching. Do not loop search → empty? → create.

Per line in: {"id":"jane@example.com","properties":{"firstname":"Jane","jobtitle":"VP"}} Per line out: {"id":"123","ok":true,"data":{...}} or {"ok":false,"error":{...}}. Order matches input. The CLI adds no fields of its own — data is the raw batch-upsert API result row.

CSV/JSONL → upsert stream

Sponsors

Details

Repository
github.com/hubspot/agent-cli-skills
Categories
AI & Agent Building, Sales & Marketing, CLI & Terminal
First seen
Jul 14, 2026

More from hubspot/agent-cli-skills

All 15
1github avatarcreating-oracle-to-postgres-master-migration-plangithub/awesome-copilotDiscovers all projects in a .NET solution, classifies each for Oracle-to-PostgreSQL migration eligibility, and produces a persistent master migration plan. Use 1.8Kskills.sh installs
2hubspot avatarsales-executionhubspot/agent-cli-skillsLog sales activities — calls, notes, meetings, tasks — against contacts and deals, with the mandatory create-then-associate step that makes them visible in the 1.8Kskills.sh installs
3hubspot avatarcustomer-retentionhubspot/agent-cli-skillsIdentify inactive/at-risk customers via CRM filters and create follow-up tasks at scale. Builds on `bulk-operations`; defers activity-creation specifics to `sal1.8Kskills.sh installs
4github avatarcreating-oracle-to-postgres-migration-bug-reportgithub/awesome-copilotCreates structured bug reports for defects found during Oracle-to-PostgreSQL migration. Use when documenting behavioral differences between Oracle and PostgreSQ1.8Kskills.sh installs
5liangdabiao avatarstock-research-executorliangdabiao/claude-code-stock-deep-research-agent股票投资调研执行引擎,执行8阶段投资尽调流程。接收stock-question-refiner生成的结构化调研指令,部署多智能体并行研究,生成带引用的投资尽调报告。覆盖:公司事实底座、行业周期、业务拆解、财务质量、股权治理、市场分歧、估值护城河、综合报告。当用户需要进行股票投资研究、基本面分析、投资尽调时使用此技能。1.8Kskills.sh installs
6hubspot avatarteam-ownershiphubspot/agent-cli-skillsAssign and reassign CRM record ownership, audit who-owns-what across object types, and handle rep transitions. Built on `bulk-operations`.1.8Kskills.sh installs