The AI-Augmented HubSpot Stack

Want to recreate the Session 2 build on your own machine? Here’s the whole thing from an empty folder. The mock version runs with no API keys at all — the AI here is Claude Code writing the endpoint, not a key inside it.

1. 0

   Blank slate

   mkdir hubspot-enrich && cd hubspot-enrich

2. 1

   Scaffold the minimal Next.js app

   Pinning @14 keeps you on the course’s Node 18+ floor.

   npx create-next-app@14 . --ts --app --no-src-dir --no-tailwind --no-eslint --import-alias "@/*" --use-npm

3. 2

   Open Claude Code

   claude

4. 3

   Write a CLAUDE.md first (optional)

   Say to Claude Code

   Create a short CLAUDE.md: Next.js App Router, TypeScript, Node 18+; one job — a HubSpot workflow calls this and it enriches a contact. Never guess a property; read it back; sandbox before production.

5. 4

   The prompt (mock-first — no keys)

   Say to Claude Code

   Add a POST route at /api/enrich that takes a contact email, looks up company context, and returns company name, size, and a one-line enrichment summary. If no company is found, return status: no_match. For now, resolve the company from a small local fixture keyed by the email domain — no external API yet. Then run it and show me it works.

6. 5

   Run it locally

   npm run dev     # -> http://localhost:3000

7. 6

   Test the round trip

   Match an email domain to one of the fixtures Claude Code created (it’ll list them), and use any unknown domain for the miss case.

   curl -X POST http://localhost:3000/api/enrich \
     -H "content-type: application/json" \
     -d '{"email":"you@<a-fixture-domain>"}'
   # -> {"companyName": ... ,"status":"matched"}
   
   curl -X POST http://localhost:3000/api/enrich \
     -H "content-type: application/json" \
     -d '{"email":"you@unknown-domain.com"}'
   # -> {"status":"no_match"}

8. 7

   Point it at your real HubSpot

   Say to Claude Code

   Now add a real mode: when HUBSPOT_TOKEN is set, look the company up live from HubSpot by the email’s domain instead of the fixture.

   Use a private-app token — a Service key from the auth section below — scoped to companies read.

   echo 'HUBSPOT_TOKEN=pat-…' > .env.local
   # restart dev, then curl a real contact's email

That’s the whole thing — no code you wrote by hand, just the ask. The CLAUDE.md guide shows how to make it repeatable.