diff --git a/referral-builder/.gitignore b/referral-builder/.gitignore
new file mode 100644
index 0000000..a725057
--- /dev/null
+++ b/referral-builder/.gitignore
@@ -0,0 +1,40 @@
+# Dependencies
+node_modules/
+
+# Environment variables
+.env
+.env*.local
+
+# OS files
+.DS_Store
+.DS_Store?
+._*
+.Spotlight-V100
+.Trashes
+ehthumbs.db
+Thumbs.db
+
+# IDE
+.vscode/
+.idea/
+*.swp
+*.swo
+*~
+
+# Build outputs
+dist/
+build/
+.next/
+out/
+
+# Logs
+*.log
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+
+# HubSpot
+.hubspot/
+
+# Vercel
+.vercel/
diff --git a/referral-builder/QUICKSTART.md b/referral-builder/QUICKSTART.md
new file mode 100644
index 0000000..fd98bfa
--- /dev/null
+++ b/referral-builder/QUICKSTART.md
@@ -0,0 +1,106 @@
+# Quick Start Guide
+
+Get the Referral Builder running in 15 minutes.
+
+## Prerequisites Checklist
+
+- [ ] HubSpot developer account
+- [ ] HubSpot private app access token with required scopes
+- [ ] Custom objects created (Program, Session, Referral)
+- [ ] Node.js 18+ installed
+- [ ] HubSpot CLI: `npm install -g @hubspot/cli`
+- [ ] Vercel account
+- [ ] Git installed
+
+## 5-Step Setup
+
+### 1️⃣ Deploy Vercel API (5 min)
+
+```bash
+cd referral-builder/vercel-api
+npm install
+cp .env.example .env
+# Edit .env and add your HUBSPOT_ACCESS_TOKEN
+npm run dev  # Test locally (optional)
+vercel       # Deploy to production
+```
+
+📝 **Save your Vercel URL**: `https://your-project.vercel.app`
+
+### 2️⃣ Configure Environment Variables in Vercel (2 min)
+
+Go to Vercel Dashboard → Settings → Environment Variables
+
+Add:
+```
+HUBSPOT_ACCESS_TOKEN=pat-na1-xxxxx
+HS_PROGRAM_OBJECT_TYPE=p_program
+HS_SESSION_OBJECT_TYPE=p_session
+HS_REFERRAL_OBJECT_TYPE=p_referral
+```
+
+### 3️⃣ Update HubSpot Card Config (3 min)
+
+**A. Edit `hubspot-card/src/app/app-hsmeta.json`:**
+```json
+{
+  "permittedUrls": {
+    "fetch": [
+      "https://api.hubapi.com",
+      "https://your-project.vercel.app"  ← YOUR VERCEL URL
+    ]
+  }
+}
+```
+
+**B. Edit `hubspot-card/src/app/cards/ReferralBuilderCard.tsx` line 13:**
+```typescript
+const API_BASE = "https://your-project.vercel.app"; // ← YOUR VERCEL URL
+```
+
+### 4️⃣ Deploy HubSpot Card (3 min)
+
+```bash
+cd ../hubspot-card
+hs auth          # Authenticate with HubSpot
+hs project upload
+```
+
+### 5️⃣ Add Card to Deal Layout (2 min)
+
+1. HubSpot → **Settings** → **Objects** → **Deals** → **Record customization**
+2. Edit your layout
+3. Right sidebar → **Add card** → Find **"Referral Builder"**
+4. Save & Publish
+
+## ✅ Test It
+
+1. Open any Deal in HubSpot
+2. You should see the **Referral Builder** card in the sidebar
+3. Try:
+   - Search for a company
+   - Select company → see programs
+   - Select program → see sessions
+   - Create a referral
+   - Update outreach status and client interest
+
+## 🚨 Common Issues
+
+| Problem | Solution |
+|---------|----------|
+| Card not visible | Add card to Deal layout in HubSpot settings |
+| API errors | Check Vercel domain is correct in both config files |
+| No companies found | Verify HUBSPOT_ACCESS_TOKEN has company read scope |
+| No programs/sessions | Check associations in HubSpot custom objects |
+
+## 📖 Need More Help?
+
+See the full [README.md](./README.md) for:
+- Detailed setup instructions
+- API endpoint documentation
+- Troubleshooting guide
+- Architecture overview
+
+---
+
+**That's it! You're ready to build referrals.** 🎉
diff --git a/referral-builder/README.md b/referral-builder/README.md
new file mode 100644
index 0000000..a4f03b2
--- /dev/null
+++ b/referral-builder/README.md
@@ -0,0 +1,651 @@
+# Camp Referral Builder
+
+A complete HubSpot integration for managing camp referrals with a Deal sidebar card and external API backend.
+
+## 📋 Overview
+
+This project provides a **Referral Builder** for HubSpot that:
+
+- Displays a custom card on Deal records
+- Allows searching for Companies (camps)
+- Lists Programs associated with Companies
+- Lists Sessions associated with Programs
+- Creates Referral records linking Deal → Company → Program → Session
+- Updates referral properties (outreach status, client interest, notes)
+
+### ✨ 2025.02 Schema Update
+
+This version has been updated to use the **2025.02 HubSpot schema** with the following improvements:
+
+- **Correct property names**: Updated from `referral_outreach_status` → `referral_status` and `referral_client_interest` → `client_interest`
+- **Upsert logic**: Create/Update operations now search for existing referrals by key to prevent duplicates
+- **Dynamic associations**: Association type IDs are fetched dynamically instead of hardcoded
+- **Auto-managed fields**: Automatically sets `referral_name`, `copied_from_deal_key`, and `copied_from_year`
+- **Dynamic enum loading**: Property dropdown options are loaded from HubSpot API
+- **Better error handling**: Improved error messages and form clearing after successful create
+
+## 🏗️ Architecture
+
+The project consists of two main parts:
+
+### 1. **HubSpot Card** (`hubspot-card/`)
+- Uses HubSpot Developer Projects with `platformVersion: 2025.2`
+- React-based UI card that appears in the Deal sidebar
+- Deployed via `hs project upload` command
+
+### 2. **Vercel API** (`vercel-api/`)
+- Next.js API routes deployed on Vercel
+- Handles all HubSpot API interactions
+- Manages custom object operations (Company, Program, Session, Referral)
+
+```
+┌─────────────────┐
+│   Deal Record   │
+│   (HubSpot UI)  │
+└────────┬────────┘
+         │
+         │ displays
+         ▼
+┌─────────────────┐        ┌──────────────────┐
+│ Referral Card   │───────▶│  Vercel API      │
+│ (React UI)      │  fetch │  (Next.js)       │
+└─────────────────┘        └────────┬─────────┘
+                                    │
+                                    │ HubSpot API
+                                    ▼
+                           ┌─────────────────┐
+                           │  HubSpot CRM    │
+                           │  (Companies,    │
+                           │   Programs,     │
+                           │   Sessions,     │
+                           │   Referrals)    │
+                           └─────────────────┘
+```
+
+## 🚀 Getting Started
+
+### Prerequisites
+
+1. **HubSpot Account** with:
+   - Developer account access
+   - Custom objects created: Program, Session, Referral
+   - Private app access token with scopes:
+     - `crm.objects.deals.read`
+     - `crm.objects.deals.write`
+     - `crm.objects.companies.read`
+     - `crm.objects.custom.read`
+     - `crm.objects.custom.write`
+
+2. **Development Tools**:
+   - Node.js 18+ installed
+   - HubSpot CLI installed: `npm install -g @hubspot/cli`
+   - Vercel account
+   - Git
+
+3. **HubSpot Custom Objects**:
+   You need to create these custom objects in HubSpot:
+   - **Program** (associated with Company)
+   - **Session** (associated with Program)
+   - **Referral** (associated with Deal, Company, Program, Session)
+
+   Key properties for **Referral** object (2025.02 schema):
+   - **Editable in UI**:
+     - `referral_key` (text) - Unique identifier
+     - `referral_status` (dropdown) - Draft, Ready to Send, Sent, Resend, Don't send (already sent)
+     - `client_interest` (dropdown) - Active / considering, Shortlist, Neutral, Unlikely, Declined, Selected
+     - `referral_note_to_company` (text area) - Notes
+     - `previously_sent_to_camp` (dropdown) - Yes (true), No (false)
+   - **Auto-managed**:
+     - `referral_name` (text) - Display name (auto-set on create)
+     - `copied_from_deal_key` (text) - Source deal key
+     - `copied_from_year` (number) - Source year
+     - `email_send_count` (number) - Email tracking
+     - `email_last_sent_datetime` (datetime) - Last email sent
+
+---
+
+## 📦 Installation
+
+### Step 1: Set Up HubSpot Custom Objects
+
+1. Go to **Settings** → **Data Management** → **Objects**
+2. Create custom objects:
+
+#### A. Program Object
+- **Name**: Program
+- **Associations**: Company (many-to-one)
+- **Properties**: name (text)
+
+#### B. Session Object
+- **Name**: Session
+- **Associations**: Program (many-to-one)
+- **Properties**:
+  - `name` (text)
+  - `start_date` (date)
+  - `end_date` (date)
+  - `price` (number)
+  - `weeks` (number)
+
+#### C. Referral Object
+- **Name**: Referral
+- **Associations**:
+  - Deal (many-to-one)
+  - Company (many-to-one)
+  - Program (many-to-one, optional)
+  - Session (many-to-one, optional)
+- **Properties** (2025.02 schema):
+  - **Editable**:
+    - `referral_key` (text, unique)
+    - `referral_status` (dropdown): Draft, Ready to Send, Sent, Resend, Don't send (already sent)
+    - `client_interest` (dropdown): Active / considering, Shortlist, Neutral, Unlikely, Declined, Selected
+    - `referral_note_to_company` (text area)
+    - `previously_sent_to_camp` (dropdown): Yes (true), No (false)
+  - **Auto-managed**:
+    - `referral_name` (text) - Auto-set on create
+    - `copied_from_deal_key` (text)
+    - `copied_from_year` (number)
+    - `email_send_count` (number)
+    - `email_last_sent_datetime` (datetime)
+
+### Step 2: Deploy Vercel API
+
+1. **Navigate to the Vercel API directory**:
+   ```bash
+   cd referral-builder/vercel-api
+   ```
+
+2. **Install dependencies**:
+   ```bash
+   npm install
+   ```
+
+3. **Set up environment variables**:
+   ```bash
+   cp .env.example .env
+   ```
+
+4. **Edit `.env`** and add your HubSpot access token:
+   ```env
+   HUBSPOT_ACCESS_TOKEN=pat-na1-xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
+
+   # Adjust these if your custom object names differ
+   HS_PROGRAM_OBJECT_TYPE=p_program
+   HS_SESSION_OBJECT_TYPE=p_session
+   HS_REFERRAL_OBJECT_TYPE=p_referral
+
+   # Adjust these if your property names differ (2025.02 schema defaults)
+   # Editable properties
+   HS_REFERRAL_KEY_PROP=referral_key
+   HS_REFERRAL_OUTREACH_PROP=referral_status
+   HS_REFERRAL_INTEREST_PROP=client_interest
+   HS_REFERRAL_NOTE_PROP=referral_note_to_company
+   HS_REFERRAL_PREVIOUSLY_SENT_PROP=previously_sent_to_camp
+
+   # Auto-managed properties
+   HS_REFERRAL_NAME_PROP=referral_name
+   HS_REFERRAL_COPIED_DEAL_KEY_PROP=copied_from_deal_key
+   HS_REFERRAL_COPIED_YEAR_PROP=copied_from_year
+
+   # Optional: Deal properties for metadata copying
+   # HS_DEAL_KEY_PROP=deal_key_property_name
+   # HS_DEAL_YEAR_PROP=deal_year_property_name
+   ```
+
+5. **Test locally** (optional):
+   ```bash
+   npm run dev
+   ```
+   Visit http://localhost:3000/api/health to verify it works.
+
+6. **Deploy to Vercel**:
+
+   **Option A: Deploy via Vercel CLI**
+   ```bash
+   npm install -g vercel
+   vercel
+   ```
+   Follow the prompts to link to your Vercel account.
+
+   **Option B: Deploy via Vercel Dashboard**
+   - Push code to GitHub
+   - Go to https://vercel.com/new
+   - Import your repository
+   - Add environment variables in Vercel dashboard
+
+7. **Configure Vercel Environment Variables**:
+   In Vercel dashboard → Settings → Environment Variables, add:
+   - `HUBSPOT_ACCESS_TOKEN`
+   - `HS_PROGRAM_OBJECT_TYPE`
+   - `HS_SESSION_OBJECT_TYPE`
+   - `HS_REFERRAL_OBJECT_TYPE`
+   - (and any other variables from `.env.example`)
+
+8. **Note your Vercel domain**:
+   After deployment, you'll get a URL like `https://your-project.vercel.app`
+
+### Step 3: Configure HubSpot Card
+
+1. **Navigate to the HubSpot card directory**:
+   ```bash
+   cd ../hubspot-card
+   ```
+
+2. **Update the Vercel domain in TWO places**:
+
+   **A. In `src/app/app-hsmeta.json`**:
+   ```json
+   {
+     "permittedUrls": {
+       "fetch": [
+         "https://api.hubapi.com",
+         "https://your-project.vercel.app"  ← CHANGE THIS
+       ]
+     }
+   }
+   ```
+
+   **B. In `src/app/cards/ReferralBuilderCard.tsx`** (line 13):
+   ```typescript
+   const API_BASE = "https://your-project.vercel.app"; // ← CHANGE THIS
+   ```
+
+3. **Authenticate HubSpot CLI**:
+   ```bash
+   hs auth
+   ```
+   Follow the prompts to authenticate with your HubSpot account.
+
+4. **Deploy to HubSpot**:
+   ```bash
+   hs project upload
+   ```
+
+   This will upload your card to HubSpot.
+
+### Step 4: Add Card to Deal Layout
+
+The card won't automatically appear on Deals. You need to add it:
+
+1. Go to **Settings** → **Objects** → **Deals** → **Record customization**
+2. Edit the layout you use
+3. In the right sidebar, click **"Add card"**
+4. Find **"Referral Builder"** under your app
+5. Click **Save** and **Publish**
+
+### Step 5: Test the Integration
+
+1. Open any Deal record in HubSpot
+2. The **Referral Builder** card should appear in the right sidebar
+3. Test the workflow:
+   - Search for a company
+   - Select a company → programs should load
+   - Select a program → sessions should load
+   - Create a referral
+   - Update referral properties
+   - Reload to see persisted data
+
+---
+
+## 🔧 Configuration
+
+### Custom Object Names
+
+If your custom objects use different names (e.g., `p_camp_program` instead of `p_program`):
+
+1. Update `.env` in `vercel-api/`:
+   ```env
+   HS_PROGRAM_OBJECT_TYPE=p_camp_program
+   HS_SESSION_OBJECT_TYPE=p_camp_session
+   HS_REFERRAL_OBJECT_TYPE=p_camp_referral
+   ```
+
+2. Redeploy to Vercel
+
+### Property Names
+
+If your Referral object uses different property names:
+
+1. Update `.env` in `vercel-api/`:
+   ```env
+   HS_REFERRAL_KEY_PROP=custom_referral_key
+   HS_REFERRAL_OUTREACH_PROP=custom_outreach_status
+   # etc.
+   ```
+
+2. Update the card UI in `ReferralBuilderCard.tsx` where it calls `updateReferral()` to use matching property names
+
+3. Redeploy both Vercel API and HubSpot card
+
+---
+
+## 📁 Project Structure
+
+```
+referral-builder/
+├── hubspot-card/                      # HubSpot UI Extension
+│   ├── hsproject.json                 # Project config (platformVersion: 2025.2)
+│   ├── .gitignore
+│   └── src/
+│       └── app/
+│           ├── app-hsmeta.json        # App metadata
+│           └── cards/
+│               ├── card-hsmeta.json   # Card metadata
+│               ├── ReferralBuilderCard.tsx  # Card UI component
+│               └── package.json
+│
+└── vercel-api/                        # Next.js API Backend
+    ├── package.json
+    ├── tsconfig.json
+    ├── next.config.js
+    ├── vercel.json
+    ├── .env.example
+    ├── .gitignore
+    └── src/
+        ├── lib/
+        │   ├── hubspot.ts             # HubSpot API client
+        │   ├── config.ts              # Configuration constants
+        │   ├── associations.ts        # Association helper
+        │   └── objects.ts             # Object helper
+        └── app/
+            └── api/
+                ├── health/
+                │   └── route.ts       # Health check endpoint
+                ├── companies/
+                │   ├── search/
+                │   │   └── route.ts   # Search companies
+                │   └── [companyId]/
+                │       └── programs/
+                │           └── route.ts  # Get programs for company
+                ├── programs/
+                │   └── [programId]/
+                │       └── sessions/
+                │           └── route.ts  # Get sessions for program
+                ├── deals/
+                │   └── [dealId]/
+                │       └── referrals/
+                │           └── route.ts  # Get referrals for deal
+                └── referrals/
+                    ├── route.ts       # Create/upsert referral
+                    ├── properties/
+                    │   └── route.ts   # Get property definitions
+                    └── [referralId]/
+                        └── route.ts   # Update referral
+```
+
+---
+
+## 🔌 API Endpoints
+
+All endpoints are prefixed with your Vercel domain (e.g., `https://your-project.vercel.app`).
+
+### `GET /api/health`
+Health check endpoint.
+
+**Response:**
+```json
+{
+  "ok": true,
+  "ts": "2025-01-11T12:00:00.000Z"
+}
+```
+
+### `GET /api/companies/search?q={query}`
+Search for companies by name.
+
+**Parameters:**
+- `q` (required): Search query
+- `limit` (optional): Max results (default: 20)
+
+**Response:**
+```json
+{
+  "results": [
+    {
+      "id": "12345",
+      "name": "Camp Adventure"
+    }
+  ]
+}
+```
+
+### `GET /api/companies/{companyId}/programs`
+Get programs associated with a company.
+
+**Response:**
+```json
+{
+  "results": [
+    {
+      "id": "67890",
+      "name": "Summer Adventure Program"
+    }
+  ]
+}
+```
+
+### `GET /api/programs/{programId}/sessions`
+Get sessions associated with a program.
+
+**Response:**
+```json
+{
+  "results": [
+    {
+      "id": "11111",
+      "name": "Session 1",
+      "startDate": "2025-06-01",
+      "endDate": "2025-06-15",
+      "price": "1200",
+      "weeks": "2"
+    }
+  ]
+}
+```
+
+### `GET /api/deals/{dealId}/referrals`
+Get all referrals associated with a deal.
+
+**Response:**
+```json
+{
+  "results": [
+    {
+      "id": "22222",
+      "referralKey": "12345-67890",
+      "outreachStatus": "Draft",
+      "clientInterest": "Active / considering",
+      "note": "Great fit for the family",
+      "company": {
+        "id": "67890",
+        "name": "Camp Adventure"
+      },
+      "program": {
+        "id": "11111",
+        "name": "Summer Adventure Program"
+      },
+      "session": {
+        "id": "33333",
+        "name": "Session 1",
+        "startDate": "2025-06-01",
+        "endDate": "2025-06-15",
+        "price": "1200"
+      }
+    }
+  ]
+}
+```
+
+### `GET /api/referrals/properties`
+Get property definitions for referral enums (used for dropdown options).
+
+**Response:**
+```json
+{
+  "properties": {
+    "referral_status": {
+      "name": "referral_status",
+      "label": "Outreach Status",
+      "options": [
+        { "label": "Draft", "value": "Draft" },
+        { "label": "Ready to Send", "value": "Ready to Send" }
+      ]
+    },
+    "client_interest": {
+      "name": "client_interest",
+      "label": "Client Interest",
+      "options": [
+        { "label": "Active / considering", "value": "Active / considering" }
+      ]
+    }
+  }
+}
+```
+
+### `POST /api/referrals`
+Create a new referral (or update if already exists).
+
+**Request body:**
+```json
+{
+  "dealId": "12345",
+  "companyId": "67890",
+  "programId": "11111",
+  "sessionId": "33333",
+  "note": "Great fit for the family",
+  "outreachStatus": "Draft",
+  "clientInterest": "Active / considering"
+}
+```
+
+**Response:**
+```json
+{
+  "ok": true,
+  "referralId": "22222",
+  "created": true,
+  "updated": false
+}
+```
+
+### `PATCH /api/referrals/{referralId}`
+Update referral properties.
+
+**Request body:**
+```json
+{
+  "properties": {
+    "referral_status": "Sent",
+    "client_interest": "Shortlist",
+    "referral_note_to_company": "Updated note"
+  }
+}
+```
+
+**Response:**
+```json
+{
+  "ok": true
+}
+```
+
+---
+
+## 🐛 Troubleshooting
+
+### Card not appearing on Deals
+- Verify you added the card to the Deal layout (Settings → Objects → Deals → Record customization)
+- Check that `objectTypes: ["deals"]` is set in `card-hsmeta.json`
+- Re-run `hs project upload`
+
+### API requests failing
+- Verify your Vercel domain is correctly set in both `app-hsmeta.json` and `ReferralBuilderCard.tsx`
+- Check Vercel logs for errors
+- Verify `HUBSPOT_ACCESS_TOKEN` is set in Vercel environment variables
+- Test the health endpoint: `https://your-project.vercel.app/api/health`
+
+### Custom objects not found
+- Verify object type IDs in `.env` match your HubSpot setup
+- Check object API names in HubSpot Settings → Objects
+- Use `p_{object_name}` format or full `objectTypeId`
+
+### Permission errors
+- Verify your HubSpot access token has all required scopes
+- Check token hasn't expired
+- Ensure token has access to custom objects
+
+### Associations not working
+- Verify associations are set up between objects in HubSpot
+- Check that Companies have associated Programs
+- Check that Programs have associated Sessions
+- Ensure association labels are set correctly
+
+---
+
+## 🔄 Updating the Application
+
+### Update HubSpot Card UI
+
+1. Make changes to `ReferralBuilderCard.tsx`
+2. Run:
+   ```bash
+   cd hubspot-card
+   hs project upload
+   ```
+3. Refresh the Deal page in HubSpot
+
+### Update Vercel API
+
+1. Make changes to API routes or helpers
+2. Commit and push to GitHub (if using automatic deployments)
+3. Or run:
+   ```bash
+   cd vercel-api
+   vercel --prod
+   ```
+4. Changes take effect immediately (no HubSpot refresh needed)
+
+---
+
+## 📚 Additional Resources
+
+- [HubSpot Developer Projects Documentation](https://developers.hubspot.com/docs/platform/developer-projects)
+- [HubSpot UI Extensions Documentation](https://developers.hubspot.com/docs/platform/ui-extensions-overview)
+- [HubSpot CRM API Documentation](https://developers.hubspot.com/docs/api/crm/understanding-the-crm)
+- [Vercel Documentation](https://vercel.com/docs)
+- [Next.js API Routes](https://nextjs.org/docs/api-routes/introduction)
+
+---
+
+## 🤝 Support
+
+If you encounter issues:
+
+1. Check the Troubleshooting section above
+2. Review Vercel deployment logs
+3. Check HubSpot developer console for errors
+4. Verify all environment variables are set correctly
+
+---
+
+## 📝 License
+
+This project is provided as-is for internal use.
+
+---
+
+## ✅ Next Steps / Future Enhancements
+
+Consider implementing:
+
+1. **Session Multi-Select**: Allow selecting multiple session options per referral
+2. **Copy Prior Year Referrals**: Clone referrals from previous Deals for the same household
+3. **Auto-Update Deal**: When client interest becomes "Selected", update Deal amount and close date
+4. **Enhanced Error Handling**: More robust error messages and loading states
+5. **Bulk Operations**: Create multiple referrals at once
+6. **Filtering & Sorting**: Filter referrals by status, sort by date/interest
+7. **Email Integration**: Send referral emails directly from the card
+8. **Analytics Dashboard**: Track referral conversion rates
+
+---
+
+**Built with ❤️ using HubSpot 2025.2 Platform and Next.js**
diff --git a/referral-builder/hubspot-card/.gitignore b/referral-builder/hubspot-card/.gitignore
new file mode 100644
index 0000000..26f3f0a
--- /dev/null
+++ b/referral-builder/hubspot-card/.gitignore
@@ -0,0 +1,6 @@
+node_modules/
+.env
+.DS_Store
+dist/
+*.log
+.hubspot/
diff --git a/referral-builder/hubspot-card/hsproject.json b/referral-builder/hubspot-card/hsproject.json
new file mode 100644
index 0000000..98479b8
--- /dev/null
+++ b/referral-builder/hubspot-card/hsproject.json
@@ -0,0 +1,5 @@
+{
+  "name": "Camp Referral Builder",
+  "srcDir": "src",
+  "platformVersion": "2025.2"
+}
diff --git a/referral-builder/hubspot-card/src/app/app-hsmeta.json b/referral-builder/hubspot-card/src/app/app-hsmeta.json
new file mode 100644
index 0000000..dd93be5
--- /dev/null
+++ b/referral-builder/hubspot-card/src/app/app-hsmeta.json
@@ -0,0 +1,35 @@
+{
+  "uid": "camp_referral_builder_app",
+  "type": "app",
+  "config": {
+    "description": "Referral Builder (Deal → Company → Program → Session → Referral)",
+    "name": "Camp Referral Builder",
+    "distribution": "private",
+    "auth": {
+      "type": "static",
+      "requiredScopes": [
+        "crm.objects.deals.read",
+        "crm.objects.deals.write",
+        "crm.objects.companies.read",
+        "crm.objects.custom.read",
+        "crm.objects.custom.write"
+      ],
+      "optionalScopes": [],
+      "conditionallyRequiredScopes": []
+    },
+    "permittedUrls": {
+      "fetch": [
+        "https://api.hubapi.com",
+        "https://YOUR_VERCEL_DOMAIN"
+      ],
+      "iframe": [],
+      "img": []
+    },
+    "support": {
+      "supportEmail": "support@example.com",
+      "documentationUrl": "https://example.com/docs",
+      "supportUrl": "https://example.com/support",
+      "supportPhone": "+18005555555"
+    }
+  }
+}
diff --git a/referral-builder/hubspot-card/src/app/cards/ReferralBuilderCard.tsx b/referral-builder/hubspot-card/src/app/cards/ReferralBuilderCard.tsx
new file mode 100644
index 0000000..2d09ebf
--- /dev/null
+++ b/referral-builder/hubspot-card/src/app/cards/ReferralBuilderCard.tsx
@@ -0,0 +1,452 @@
+import React, { useEffect, useMemo, useState } from "react";
+import {
+  hubspot,
+  Box,
+  Button,
+  Divider,
+  Flex,
+  Heading,
+  Input,
+  Select,
+  Text,
+  TextArea,
+} from "@hubspot/ui-extensions";
+
+const API_BASE = "https://YOUR_VERCEL_DOMAIN"; // <-- CHANGE THIS (no trailing slash)
+
+type Option = { label: string; value: string };
+
+type ReferralRow = {
+  id: string;
+  referralKey?: string;
+  outreachStatus?: string;
+  clientInterest?: string;
+  note?: string;
+  company?: { id?: string; name?: string };
+  program?: { id?: string; name?: string };
+  session?: { id?: string; name?: string; startDate?: string; endDate?: string; price?: string };
+};
+
+// Default options (will be replaced by API-loaded options if available)
+const DEFAULT_OUTREACH_OPTIONS: Option[] = [
+  { label: "Draft", value: "Draft" },
+  { label: "Ready to Send", value: "Ready to Send" },
+  { label: "Sent", value: "Sent" },
+  { label: "Resend", value: "Resend" },
+  { label: "Don't send (already sent)", value: "Don't send (already sent)" },
+];
+
+const DEFAULT_INTEREST_OPTIONS: Option[] = [
+  { label: "Active / considering", value: "Active / considering" },
+  { label: "Shortlist", value: "Shortlist" },
+  { label: "Neutral", value: "Neutral" },
+  { label: "Unlikely", value: "Unlikely" },
+  { label: "Declined", value: "Declined" },
+  { label: "Selected", value: "Selected" },
+];
+
+const DEFAULT_PREVIOUSLY_SENT_OPTIONS: Option[] = [
+  { label: "Yes (true)", value: "Yes (true)" },
+  { label: "No (false)", value: "No (false)" },
+];
+
+hubspot.extend(({ context, actions }) => (
+  <ReferralBuilderCard context={context} actions={actions} />
+));
+
+function ReferralBuilderCard({ context, actions }: any) {
+  const dealId = context?.crm?.objectId ? String(context.crm.objectId) : null;
+
+  const [busy, setBusy] = useState(false);
+  const [error, setError] = useState<string | null>(null);
+
+  const [referrals, setReferrals] = useState<ReferralRow[]>([]);
+
+  const [companyQuery, setCompanyQuery] = useState("");
+  const [companyOptions, setCompanyOptions] = useState<Option[]>([]);
+  const [selectedCompanyId, setSelectedCompanyId] = useState<string>("");
+
+  const [programOptions, setProgramOptions] = useState<Option[]>([]);
+  const [selectedProgramId, setSelectedProgramId] = useState<string>("");
+
+  const [sessionOptions, setSessionOptions] = useState<Option[]>([]);
+  const [selectedSessionId, setSelectedSessionId] = useState<string>("");
+
+  const [note, setNote] = useState("");
+
+  const [outreachOptions, setOutreachOptions] = useState<Option[]>(DEFAULT_OUTREACH_OPTIONS);
+  const [interestOptions, setInterestOptions] = useState<Option[]>(DEFAULT_INTEREST_OPTIONS);
+  const [previouslySentOptions, setPreviouslySentOptions] = useState<Option[]>(DEFAULT_PREVIOUSLY_SENT_OPTIONS);
+
+  const canCreate = useMemo(() => {
+    return Boolean(dealId && selectedCompanyId);
+  }, [dealId, selectedCompanyId]);
+
+  async function apiRequest(path: string, init?: { method?: string; body?: any }) {
+    const url = `${API_BASE}${path}`;
+    const headers: Record<string, string> = {};
+
+    if (init?.body) {
+      headers["Content-Type"] = "application/json";
+    }
+
+    const res = await hubspot.fetch(url, {
+      method: init?.method || "GET",
+      headers,
+      body: init?.body ? JSON.stringify(init.body) : undefined,
+    });
+
+    let data: any = null;
+    try {
+      data = await res.json();
+    } catch (e) {
+      // ignore
+    }
+
+    if (!res.ok) {
+      const msg = data?.error || data?.message || `Request failed (${res.status})`;
+      throw new Error(msg);
+    }
+    return data;
+  }
+
+  async function loadPropertyDefinitions() {
+    try {
+      const data = await apiRequest(`/api/referrals/properties`);
+      const props = data?.properties || {};
+
+      // Update options if available from API
+      if (props.referral_status?.options?.length) {
+        setOutreachOptions(props.referral_status.options);
+      }
+      if (props.client_interest?.options?.length) {
+        setInterestOptions(props.client_interest.options);
+      }
+      if (props.previously_sent_to_camp?.options?.length) {
+        setPreviouslySentOptions(props.previously_sent_to_camp.options);
+      }
+    } catch (e) {
+      console.error("Failed to load property definitions:", e);
+      // Continue with default options
+    }
+  }
+
+  async function loadReferrals() {
+    if (!dealId) return;
+    const data = await apiRequest(`/api/deals/${dealId}/referrals`);
+    setReferrals(data?.results || []);
+  }
+
+  async function searchCompanies() {
+    if (!companyQuery.trim()) {
+      setCompanyOptions([]);
+      return;
+    }
+    const data = await apiRequest(`/api/companies/search?q=${encodeURIComponent(companyQuery.trim())}`);
+    const opts: Option[] = (data?.results || []).map((c: any) => ({
+      label: c.name || `Company ${c.id}`,
+      value: String(c.id),
+    }));
+    setCompanyOptions(opts);
+  }
+
+  async function loadPrograms(companyId: string) {
+    setProgramOptions([]);
+    setSelectedProgramId("");
+    setSessionOptions([]);
+    setSelectedSessionId("");
+
+    if (!companyId) return;
+    const data = await apiRequest(`/api/companies/${companyId}/programs`);
+    const opts: Option[] = (data?.results || []).map((p: any) => ({
+      label: p.name || `Program ${p.id}`,
+      value: String(p.id),
+    }));
+    setProgramOptions(opts);
+  }
+
+  async function loadSessions(programId: string) {
+    setSessionOptions([]);
+    setSelectedSessionId("");
+
+    if (!programId) return;
+    const data = await apiRequest(`/api/programs/${programId}/sessions`);
+
+    const opts: Option[] = (data?.results || []).map((s: any) => {
+      const labelParts = [s.name || `Session ${s.id}`];
+      if (s.startDate) labelParts.push(`(${s.startDate})`);
+      if (s.price) labelParts.push(`$${s.price}`);
+      return { label: labelParts.join(" "), value: String(s.id) };
+    });
+
+    setSessionOptions(opts);
+  }
+
+  async function createReferral() {
+    if (!dealId) return;
+    if (!selectedCompanyId) return;
+
+    const payload = {
+      dealId,
+      companyId: selectedCompanyId,
+      programId: selectedProgramId || undefined,
+      sessionId: selectedSessionId || undefined,
+      note: note || undefined,
+    };
+
+    const data = await apiRequest(`/api/referrals`, { method: "POST", body: payload });
+
+    const message = data?.created
+      ? `Referral created (ID ${data?.referralId || "unknown"})`
+      : `Referral updated (ID ${data?.referralId || "unknown"})`;
+
+    actions?.addAlert?.({
+      type: "success",
+      message,
+    });
+
+    // Clear form
+    setNote("");
+    setSelectedCompanyId("");
+    setSelectedProgramId("");
+    setSelectedSessionId("");
+    setCompanyQuery("");
+    setCompanyOptions([]);
+    setProgramOptions([]);
+    setSessionOptions([]);
+
+    // Refresh referrals list
+    await loadReferrals();
+  }
+
+  async function updateReferral(referralId: string, properties: Record<string, any>) {
+    await apiRequest(`/api/referrals/${referralId}`, {
+      method: "PATCH",
+      body: { properties },
+    });
+    actions?.addAlert?.({ type: "success", message: "Referral updated" });
+    await loadReferrals();
+  }
+
+  useEffect(() => {
+    (async () => {
+      setError(null);
+      if (!dealId) return;
+      try {
+        setBusy(true);
+        await Promise.all([loadReferrals(), loadPropertyDefinitions()]);
+      } catch (e: any) {
+        setError(e?.message || "Failed to load data");
+      } finally {
+        setBusy(false);
+      }
+    })();
+    // eslint-disable-next-line react-hooks/exhaustive-deps
+  }, [dealId]);
+
+  if (!dealId) {
+    return (
+      <Box>
+        <Text>This card is meant to run on a Deal record.</Text>
+      </Box>
+    );
+  }
+
+  return (
+    <Flex direction="column" gap="md">
+      <Heading>Referral Builder</Heading>
+      <Text>Deal ID: {dealId}</Text>
+
+      {error ? <Text format={{ color: "red" }}>{error}</Text> : null}
+
+      <Divider />
+
+      <Heading level="h4">Existing referrals</Heading>
+      <Button
+        variant="secondary"
+        onClick={async () => {
+          setError(null);
+          try {
+            setBusy(true);
+            await loadReferrals();
+          } catch (e: any) {
+            setError(e?.message || "Reload failed");
+          } finally {
+            setBusy(false);
+          }
+        }}
+      >
+        Reload
+      </Button>
+
+      {busy ? <Text>Loading…</Text> : null}
+
+      {referrals.length === 0 ? (
+        <Text>No referrals yet.</Text>
+      ) : (
+        <Flex direction="column" gap="sm">
+          {referrals.map((r) => (
+            <Box key={r.id}>
+              <Text>
+                <strong>{r.company?.name || "Company"}</strong>
+                {" — "}
+                {r.program?.name || "Program"}
+                {" — "}
+                {r.session?.name || "Session"}
+              </Text>
+
+              <Flex direction="row" gap="sm">
+                <Select
+                  name={`outreach-${r.id}`}
+                  label="Outreach"
+                  options={outreachOptions}
+                  value={r.outreachStatus || ""}
+                  onChange={(val: string) => {
+                    setReferrals((prev) =>
+                      prev.map((x) =>
+                        x.id === r.id ? { ...x, outreachStatus: val } : x
+                      )
+                    );
+                  }}
+                />
+
+                <Select
+                  name={`interest-${r.id}`}
+                  label="Client interest"
+                  options={interestOptions}
+                  value={r.clientInterest || ""}
+                  onChange={(val: string) => {
+                    setReferrals((prev) =>
+                      prev.map((x) =>
+                        x.id === r.id ? { ...x, clientInterest: val } : x
+                      )
+                    );
+                  }}
+                />
+              </Flex>
+
+              <TextArea
+                name={`note-${r.id}`}
+                label="Note to company"
+                value={r.note || ""}
+                onChange={(val: string) => {
+                  setReferrals((prev) =>
+                    prev.map((x) => (x.id === r.id ? { ...x, note: val } : x))
+                  );
+                }}
+              />
+
+              <Button
+                onClick={async () => {
+                  setError(null);
+                  try {
+                    setBusy(true);
+                    await updateReferral(r.id, {
+                      referral_status: r.outreachStatus || "",
+                      client_interest: r.clientInterest || "",
+                      referral_note_to_company: r.note || "",
+                    });
+                  } catch (e: any) {
+                    setError(e?.message || "Update failed");
+                  } finally {
+                    setBusy(false);
+                  }
+                }}
+              >
+                Save
+              </Button>
+
+              <Divider />
+            </Box>
+          ))}
+        </Flex>
+      )}
+
+      <Divider />
+
+      <Heading level="h4">Add referral</Heading>
+
+      <Input
+        name="companyQuery"
+        label="Search company"
+        value={companyQuery}
+        onChange={(val: string) => setCompanyQuery(val)}
+        placeholder="Type a camp/company name..."
+      />
+      <Button variant="secondary" onClick={searchCompanies}>
+        Search
+      </Button>
+
+      <Select
+        name="company"
+        label="Company"
+        options={companyOptions}
+        value={selectedCompanyId}
+        onChange={async (val: string) => {
+          setSelectedCompanyId(val);
+          setError(null);
+          try {
+            setBusy(true);
+            await loadPrograms(val);
+          } catch (e: any) {
+            setError(e?.message || "Failed to load programs");
+          } finally {
+            setBusy(false);
+          }
+        }}
+      />
+
+      <Select
+        name="program"
+        label="Program (optional)"
+        options={programOptions}
+        value={selectedProgramId}
+        onChange={async (val: string) => {
+          setSelectedProgramId(val);
+          setError(null);
+          try {
+            setBusy(true);
+            await loadSessions(val);
+          } catch (e: any) {
+            setError(e?.message || "Failed to load sessions");
+          } finally {
+            setBusy(false);
+          }
+        }}
+      />
+
+      <Select
+        name="session"
+        label="Session (optional)"
+        options={sessionOptions}
+        value={selectedSessionId}
+        onChange={(val: string) => setSelectedSessionId(val)}
+      />
+
+      <TextArea
+        name="note"
+        label="Note to company"
+        value={note}
+        onChange={(val: string) => setNote(val)}
+        placeholder="Optional note that will appear on the Referral record"
+      />
+
+      <Button
+        disabled={!canCreate || busy}
+        onClick={async () => {
+          setError(null);
+          try {
+            setBusy(true);
+            await createReferral();
+          } catch (e: any) {
+            setError(e?.message || "Create failed");
+          } finally {
+            setBusy(false);
+          }
+        }}
+      >
+        Create referral
+      </Button>
+    </Flex>
+  );
+}
diff --git a/referral-builder/hubspot-card/src/app/cards/card-hsmeta.json b/referral-builder/hubspot-card/src/app/cards/card-hsmeta.json
new file mode 100644
index 0000000..dc3e589
--- /dev/null
+++ b/referral-builder/hubspot-card/src/app/cards/card-hsmeta.json
@@ -0,0 +1,13 @@
+{
+  "uid": "camp_referral_builder_card",
+  "type": "card",
+  "config": {
+    "name": "Referral Builder",
+    "description": "Create and update referrals for this Deal.",
+    "location": "crm.record.sidebar",
+    "entrypoint": "/app/cards/ReferralBuilderCard.tsx",
+    "objectTypes": [
+      "deals"
+    ]
+  }
+}
diff --git a/referral-builder/hubspot-card/src/app/cards/package.json b/referral-builder/hubspot-card/src/app/cards/package.json
new file mode 100644
index 0000000..7773920
--- /dev/null
+++ b/referral-builder/hubspot-card/src/app/cards/package.json
@@ -0,0 +1,8 @@
+{
+  "name": "camp-referral-builder-card",
+  "version": "1.0.0",
+  "description": "Referral Builder Card",
+  "dependencies": {
+    "@hubspot/ui-extensions": "latest"
+  }
+}
diff --git a/referral-builder/vercel-api/.env.example b/referral-builder/vercel-api/.env.example
new file mode 100644
index 0000000..8bb2370
--- /dev/null
+++ b/referral-builder/vercel-api/.env.example
@@ -0,0 +1,27 @@
+# HubSpot API Configuration
+HUBSPOT_ACCESS_TOKEN=your_hubspot_access_token_here
+
+# Custom Object Type IDs (adjust based on your HubSpot setup)
+# Use the shorthand p_{object_name} or the full objectTypeId/fullyQualifiedName
+HS_PROGRAM_OBJECT_TYPE=p_program
+HS_SESSION_OBJECT_TYPE=p_session
+HS_REFERRAL_OBJECT_TYPE=p_referral
+
+# Referral Property Names - 2025.02 Schema (adjust based on your custom object properties)
+# Editable in UI
+HS_REFERRAL_KEY_PROP=referral_key
+HS_REFERRAL_OUTREACH_PROP=referral_status
+HS_REFERRAL_INTEREST_PROP=client_interest
+HS_REFERRAL_NOTE_PROP=referral_note_to_company
+HS_REFERRAL_PREVIOUSLY_SENT_PROP=previously_sent_to_camp
+
+# Auto-managed properties
+HS_REFERRAL_NAME_PROP=referral_name
+HS_REFERRAL_COPIED_DEAL_KEY_PROP=copied_from_deal_key
+HS_REFERRAL_COPIED_YEAR_PROP=copied_from_year
+HS_REFERRAL_EMAIL_COUNT_PROP=email_send_count
+HS_REFERRAL_EMAIL_LAST_SENT_PROP=email_last_sent_datetime
+
+# Deal properties for metadata copying (optional - leave unset to use defaults)
+# HS_DEAL_KEY_PROP=deal_key_property_name
+# HS_DEAL_YEAR_PROP=deal_year_property_name
diff --git a/referral-builder/vercel-api/.gitignore b/referral-builder/vercel-api/.gitignore
new file mode 100644
index 0000000..87b1bdd
--- /dev/null
+++ b/referral-builder/vercel-api/.gitignore
@@ -0,0 +1,34 @@
+# Dependencies
+node_modules/
+/.pnp
+.pnp.js
+
+# Testing
+/coverage
+
+# Next.js
+/.next/
+/out/
+
+# Production
+/build
+
+# Misc
+.DS_Store
+*.pem
+
+# Debug
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+
+# Local env files
+.env
+.env*.local
+
+# Vercel
+.vercel
+
+# TypeScript
+*.tsbuildinfo
+next-env.d.ts
diff --git a/referral-builder/vercel-api/next.config.js b/referral-builder/vercel-api/next.config.js
new file mode 100644
index 0000000..642fd36
--- /dev/null
+++ b/referral-builder/vercel-api/next.config.js
@@ -0,0 +1,12 @@
+/** @type {import('next').NextConfig} */
+const nextConfig = {
+  reactStrictMode: true,
+  typescript: {
+    ignoreBuildErrors: false,
+  },
+  eslint: {
+    ignoreDuringBuilds: false,
+  },
+}
+
+module.exports = nextConfig
diff --git a/referral-builder/vercel-api/package.json b/referral-builder/vercel-api/package.json
new file mode 100644
index 0000000..4218dad
--- /dev/null
+++ b/referral-builder/vercel-api/package.json
@@ -0,0 +1,26 @@
+{
+  "name": "camp-referral-builder-api",
+  "version": "1.0.0",
+  "description": "Referral Builder API for HubSpot integration",
+  "private": true,
+  "scripts": {
+    "dev": "next dev",
+    "build": "next build",
+    "start": "next start",
+    "lint": "next lint"
+  },
+  "dependencies": {
+    "next": "^14.1.0",
+    "react": "^18.2.0",
+    "react-dom": "^18.2.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.11.0",
+    "@types/react": "^18.2.0",
+    "@types/react-dom": "^18.2.0",
+    "typescript": "^5.3.0"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}
diff --git a/referral-builder/vercel-api/src/app/api/companies/[companyId]/programs/route.ts b/referral-builder/vercel-api/src/app/api/companies/[companyId]/programs/route.ts
new file mode 100644
index 0000000..18d5171
--- /dev/null
+++ b/referral-builder/vercel-api/src/app/api/companies/[companyId]/programs/route.ts
@@ -0,0 +1,30 @@
+import { NextResponse } from "next/server";
+import { HS_OBJECTS, HS_NAME_PROP } from "../../../../../lib/config";
+import { listAssociatedIds } from "../../../../../lib/associations";
+import { batchRead } from "../../../../../lib/objects";
+
+export async function GET(_req: Request, { params }: { params: { companyId: string } }) {
+  try {
+    const companyId = params.companyId;
+
+    const programIds = await listAssociatedIds(HS_OBJECTS.COMPANY_V4, companyId, HS_OBJECTS.PROGRAM);
+
+    if (!programIds.length) return NextResponse.json({ results: [] });
+
+    let programs: any[] = [];
+    try {
+      programs = await batchRead(HS_OBJECTS.PROGRAM, programIds, [HS_NAME_PROP]);
+    } catch {
+      programs = await batchRead(HS_OBJECTS.PROGRAM, programIds);
+    }
+
+    const results = programs.map((p: any) => ({
+      id: String(p.id),
+      name: p?.properties?.[HS_NAME_PROP] || p?.properties?.name || `Program ${p.id}`,
+    }));
+
+    return NextResponse.json({ results });
+  } catch (e: any) {
+    return NextResponse.json({ error: e?.message || "Failed to load programs" }, { status: 500 });
+  }
+}
diff --git a/referral-builder/vercel-api/src/app/api/companies/search/route.ts b/referral-builder/vercel-api/src/app/api/companies/search/route.ts
new file mode 100644
index 0000000..9031db6
--- /dev/null
+++ b/referral-builder/vercel-api/src/app/api/companies/search/route.ts
@@ -0,0 +1,30 @@
+import { NextResponse } from "next/server";
+import { hsPost } from "../../../../lib/hubspot";
+import { HS_OBJECTS } from "../../../../lib/config";
+
+export async function GET(req: Request) {
+  try {
+    const { searchParams } = new URL(req.url);
+    const q = (searchParams.get("q") || "").trim();
+    const limit = Number(searchParams.get("limit") || "20");
+
+    if (!q) return NextResponse.json({ results: [] });
+
+    const body = {
+      query: q,
+      limit,
+      properties: ["name"],
+    };
+
+    const data: any = await hsPost(`/crm/v3/objects/${HS_OBJECTS.COMPANY_V3}/search`, body);
+
+    const results = (data?.results || []).map((c: any) => ({
+      id: String(c.id),
+      name: c?.properties?.name || `Company ${c.id}`,
+    }));
+
+    return NextResponse.json({ results });
+  } catch (e: any) {
+    return NextResponse.json({ error: e?.message || "Company search failed" }, { status: 500 });
+  }
+}
diff --git a/referral-builder/vercel-api/src/app/api/deals/[dealId]/referrals/route.ts b/referral-builder/vercel-api/src/app/api/deals/[dealId]/referrals/route.ts
new file mode 100644
index 0000000..b44132c
--- /dev/null
+++ b/referral-builder/vercel-api/src/app/api/deals/[dealId]/referrals/route.ts
@@ -0,0 +1,98 @@
+import { NextResponse } from "next/server";
+import { HS_OBJECTS, HS_REFERRAL_PROPS } from "../../../../../lib/config";
+import { listAssociatedIds } from "../../../../../lib/associations";
+import { batchRead } from "../../../../../lib/objects";
+
+export async function GET(_req: Request, { params }: { params: { dealId: string } }) {
+  try {
+    const dealId = params.dealId;
+
+    // 1) Referral IDs associated to this Deal
+    const referralIds = await listAssociatedIds(HS_OBJECTS.DEAL_V4, dealId, HS_OBJECTS.REFERRAL);
+    if (!referralIds.length) return NextResponse.json({ results: [] });
+
+    // 2) Load referral properties
+    let referrals: any[] = [];
+    try {
+      referrals = await batchRead(HS_OBJECTS.REFERRAL, referralIds, [
+        HS_REFERRAL_PROPS.KEY,
+        HS_REFERRAL_PROPS.OUTREACH,
+        HS_REFERRAL_PROPS.INTEREST,
+        HS_REFERRAL_PROPS.NOTE,
+      ]);
+    } catch {
+      referrals = await batchRead(HS_OBJECTS.REFERRAL, referralIds);
+    }
+
+    // 3) For each referral, fetch its associated Company/Program/Session IDs (simple & ok for small volumes)
+    const byReferral: Record<string, { companyId?: string; programId?: string; sessionId?: string }> = {};
+    const companyIds = new Set<string>();
+    const programIds = new Set<string>();
+    const sessionIds = new Set<string>();
+
+    for (const r of referrals) {
+      const rid = String(r.id);
+
+      const cIds = await listAssociatedIds(HS_OBJECTS.REFERRAL, rid, HS_OBJECTS.COMPANY_V4);
+      const pIds = await listAssociatedIds(HS_OBJECTS.REFERRAL, rid, HS_OBJECTS.PROGRAM);
+      const sIds = await listAssociatedIds(HS_OBJECTS.REFERRAL, rid, HS_OBJECTS.SESSION);
+
+      const companyId = cIds[0] ? String(cIds[0]) : undefined;
+      const programId = pIds[0] ? String(pIds[0]) : undefined;
+      const sessionId = sIds[0] ? String(sIds[0]) : undefined;
+
+      byReferral[rid] = { companyId, programId, sessionId };
+
+      if (companyId) companyIds.add(companyId);
+      if (programId) programIds.add(programId);
+      if (sessionId) sessionIds.add(sessionId);
+    }
+
+    // 4) Batch read associated objects for names
+    const companies = await batchRead(HS_OBJECTS.COMPANY_V3, Array.from(companyIds), ["name"]);
+    const programs = await batchRead(HS_OBJECTS.PROGRAM, Array.from(programIds), ["name"]);
+    const sessions = await batchRead(HS_OBJECTS.SESSION, Array.from(sessionIds), ["name", "start_date", "end_date", "price"]);
+
+    const companyNameById: Record<string, string> = {};
+    for (const c of companies) companyNameById[String(c.id)] = c?.properties?.name || `Company ${c.id}`;
+
+    const programNameById: Record<string, string> = {};
+    for (const p of programs) programNameById[String(p.id)] = p?.properties?.name || `Program ${p.id}`;
+
+    const sessionById: Record<string, any> = {};
+    for (const s of sessions) {
+      sessionById[String(s.id)] = {
+        id: String(s.id),
+        name: s?.properties?.name || `Session ${s.id}`,
+        startDate: s?.properties?.start_date || null,
+        endDate: s?.properties?.end_date || null,
+        price: s?.properties?.price || null,
+      };
+    }
+
+    // 5) Build response
+    const results = referrals.map((r: any) => {
+      const rid = String(r.id);
+      const assoc = byReferral[rid] || {};
+
+      const companyId = assoc.companyId;
+      const programId = assoc.programId;
+      const sessionId = assoc.sessionId;
+
+      return {
+        id: rid,
+        referralKey: r?.properties?.[HS_REFERRAL_PROPS.KEY] || null,
+        outreachStatus: r?.properties?.[HS_REFERRAL_PROPS.OUTREACH] || null,
+        clientInterest: r?.properties?.[HS_REFERRAL_PROPS.INTEREST] || null,
+        note: r?.properties?.[HS_REFERRAL_PROPS.NOTE] || null,
+        company: companyId ? { id: companyId, name: companyNameById[companyId] } : null,
+        program: programId ? { id: programId, name: programNameById[programId] } : null,
+        session: sessionId ? sessionById[sessionId] : null,
+      };
+    });
+
+    return NextResponse.json({ results });
+  } catch (e: any) {
+    return NextResponse.json({ error: e?.message || "Failed to load referrals" }, { status: 500 });
+  }
+}
diff --git a/referral-builder/vercel-api/src/app/api/health/route.ts b/referral-builder/vercel-api/src/app/api/health/route.ts
new file mode 100644
index 0000000..1994266
--- /dev/null
+++ b/referral-builder/vercel-api/src/app/api/health/route.ts
@@ -0,0 +1,5 @@
+import { NextResponse } from "next/server";
+
+export async function GET() {
+  return NextResponse.json({ ok: true, ts: new Date().toISOString() });
+}
diff --git a/referral-builder/vercel-api/src/app/api/programs/[programId]/sessions/route.ts b/referral-builder/vercel-api/src/app/api/programs/[programId]/sessions/route.ts
new file mode 100644
index 0000000..aaf37a6
--- /dev/null
+++ b/referral-builder/vercel-api/src/app/api/programs/[programId]/sessions/route.ts
@@ -0,0 +1,35 @@
+import { NextResponse } from "next/server";
+import { HS_OBJECTS } from "../../../../../lib/config";
+import { listAssociatedIds } from "../../../../../lib/associations";
+import { batchRead } from "../../../../../lib/objects";
+
+const SESSION_PROPS_CANDIDATES = ["name", "start_date", "end_date", "price", "weeks"];
+
+export async function GET(_req: Request, { params }: { params: { programId: string } }) {
+  try {
+    const programId = params.programId;
+
+    const sessionIds = await listAssociatedIds(HS_OBJECTS.PROGRAM, programId, HS_OBJECTS.SESSION);
+    if (!sessionIds.length) return NextResponse.json({ results: [] });
+
+    let sessions: any[] = [];
+    try {
+      sessions = await batchRead(HS_OBJECTS.SESSION, sessionIds, SESSION_PROPS_CANDIDATES);
+    } catch {
+      sessions = await batchRead(HS_OBJECTS.SESSION, sessionIds, ["name"]);
+    }
+
+    const results = sessions.map((s: any) => ({
+      id: String(s.id),
+      name: s?.properties?.name || `Session ${s.id}`,
+      startDate: s?.properties?.start_date || null,
+      endDate: s?.properties?.end_date || null,
+      price: s?.properties?.price || null,
+      weeks: s?.properties?.weeks || null,
+    }));
+
+    return NextResponse.json({ results });
+  } catch (e: any) {
+    return NextResponse.json({ error: e?.message || "Failed to load sessions" }, { status: 500 });
+  }
+}
diff --git a/referral-builder/vercel-api/src/app/api/referrals/[referralId]/route.ts b/referral-builder/vercel-api/src/app/api/referrals/[referralId]/route.ts
new file mode 100644
index 0000000..d5b667c
--- /dev/null
+++ b/referral-builder/vercel-api/src/app/api/referrals/[referralId]/route.ts
@@ -0,0 +1,19 @@
+import { NextResponse } from "next/server";
+import { HS_OBJECTS } from "../../../../lib/config";
+import { hsPatch } from "../../../../lib/hubspot";
+
+export async function PATCH(req: Request, { params }: { params: { referralId: string } }) {
+  try {
+    const referralId = params.referralId;
+    const body = await req.json();
+    const properties = body?.properties || {};
+
+    await hsPatch(`/crm/v3/objects/${encodeURIComponent(HS_OBJECTS.REFERRAL)}/${encodeURIComponent(referralId)}`, {
+      properties,
+    });
+
+    return NextResponse.json({ ok: true });
+  } catch (e: any) {
+    return NextResponse.json({ error: e?.message || "Failed to update referral" }, { status: 500 });
+  }
+}
diff --git a/referral-builder/vercel-api/src/app/api/referrals/properties/route.ts b/referral-builder/vercel-api/src/app/api/referrals/properties/route.ts
new file mode 100644
index 0000000..41ac855
--- /dev/null
+++ b/referral-builder/vercel-api/src/app/api/referrals/properties/route.ts
@@ -0,0 +1,59 @@
+import { NextResponse } from "next/server";
+import { HS_OBJECTS, HS_REFERRAL_PROPS } from "../../../../lib/config";
+import { hsGet } from "../../../../lib/hubspot";
+
+type PropertyOption = {
+  label: string;
+  value: string;
+};
+
+type PropertyDefinition = {
+  name: string;
+  label: string;
+  options: PropertyOption[];
+};
+
+export async function GET(_req: Request) {
+  try {
+    // Fetch property definitions for the referral object
+    const propertyNames = [
+      HS_REFERRAL_PROPS.OUTREACH,
+      HS_REFERRAL_PROPS.INTEREST,
+      HS_REFERRAL_PROPS.PREVIOUSLY_SENT,
+    ];
+
+    const definitions: Record<string, PropertyDefinition> = {};
+
+    for (const propName of propertyNames) {
+      try {
+        const path = `/crm/v3/properties/${encodeURIComponent(HS_OBJECTS.REFERRAL)}/${encodeURIComponent(propName)}`;
+        const data: any = await hsGet(path);
+
+        const options: PropertyOption[] = [];
+
+        if (data?.options && Array.isArray(data.options)) {
+          for (const opt of data.options) {
+            options.push({
+              label: opt.label || opt.value || "",
+              value: opt.value || "",
+            });
+          }
+        }
+
+        definitions[propName] = {
+          name: data?.name || propName,
+          label: data?.label || propName,
+          options,
+        };
+      } catch (e) {
+        console.error(`Failed to fetch property definition for ${propName}:`, e);
+        // Continue with other properties even if one fails
+      }
+    }
+
+    return NextResponse.json({ properties: definitions });
+  } catch (e: any) {
+    console.error("Error in GET /api/referrals/properties:", e);
+    return NextResponse.json({ error: e?.message || "Failed to fetch property definitions" }, { status: 500 });
+  }
+}
diff --git a/referral-builder/vercel-api/src/app/api/referrals/route.ts b/referral-builder/vercel-api/src/app/api/referrals/route.ts
new file mode 100644
index 0000000..7d8a73f
--- /dev/null
+++ b/referral-builder/vercel-api/src/app/api/referrals/route.ts
@@ -0,0 +1,133 @@
+import { NextResponse } from "next/server";
+import { HS_OBJECTS, HS_REFERRAL_PROPS, HS_DEAL_PROPS } from "../../../lib/config";
+import { hsPost, hsPatch } from "../../../lib/hubspot";
+import { searchByProperty, readObject } from "../../../lib/objects";
+import { ensureAssociation } from "../../../lib/associations";
+
+export async function POST(req: Request) {
+  try {
+    const body = await req.json();
+    const dealId = body?.dealId ? String(body.dealId) : null;
+    const companyId = body?.companyId ? String(body.companyId) : null;
+    const programId = body?.programId ? String(body.programId) : null;
+    const sessionId = body?.sessionId ? String(body.sessionId) : null;
+    const note = body?.note ? String(body.note) : null;
+    const outreachStatus = body?.outreachStatus ? String(body.outreachStatus) : null;
+    const clientInterest = body?.clientInterest ? String(body.clientInterest) : null;
+    const previouslySent = body?.previouslySent ? String(body.previouslySent) : null;
+
+    if (!dealId || !companyId) {
+      return NextResponse.json({ error: "dealId and companyId are required" }, { status: 400 });
+    }
+
+    // Compute stable unique key: 1 referral per Deal x Company
+    const referralKey = `${dealId}-${companyId}`;
+
+    // Search for existing referral by key
+    const existing = await searchByProperty(
+      HS_OBJECTS.REFERRAL,
+      HS_REFERRAL_PROPS.KEY,
+      referralKey,
+      [HS_REFERRAL_PROPS.KEY, HS_REFERRAL_PROPS.NAME]
+    );
+
+    let referralId: string;
+    let isUpdate = false;
+
+    if (existing?.id) {
+      // Update existing referral
+      referralId = String(existing.id);
+      isUpdate = true;
+
+      const updateProps: Record<string, any> = {};
+      if (note !== null) updateProps[HS_REFERRAL_PROPS.NOTE] = note;
+      if (outreachStatus !== null) updateProps[HS_REFERRAL_PROPS.OUTREACH] = outreachStatus;
+      if (clientInterest !== null) updateProps[HS_REFERRAL_PROPS.INTEREST] = clientInterest;
+      if (previouslySent !== null) updateProps[HS_REFERRAL_PROPS.PREVIOUSLY_SENT] = previouslySent;
+
+      if (Object.keys(updateProps).length > 0) {
+        await hsPatch(`/crm/v3/objects/${encodeURIComponent(HS_OBJECTS.REFERRAL)}/${encodeURIComponent(referralId)}`, {
+          properties: updateProps,
+        });
+      }
+
+      // Ensure associations exist
+      await ensureAssociation(HS_OBJECTS.REFERRAL, referralId, HS_OBJECTS.DEAL_V4, dealId);
+      await ensureAssociation(HS_OBJECTS.REFERRAL, referralId, HS_OBJECTS.COMPANY_V4, companyId);
+      if (programId) await ensureAssociation(HS_OBJECTS.REFERRAL, referralId, HS_OBJECTS.PROGRAM, programId);
+      if (sessionId) await ensureAssociation(HS_OBJECTS.REFERRAL, referralId, HS_OBJECTS.SESSION, sessionId);
+    } else {
+      // Create new referral
+      const properties: Record<string, any> = {
+        [HS_REFERRAL_PROPS.KEY]: referralKey,
+      };
+
+      // Set referral_name
+      let companyName = "Company";
+      try {
+        const companyData = await readObject(HS_OBJECTS.COMPANY_V3, companyId, ["name"]);
+        companyName = companyData?.properties?.name || "Company";
+      } catch {
+        // Ignore if company name can't be fetched
+      }
+      properties[HS_REFERRAL_PROPS.NAME] = `${companyName} – Deal ${dealId}`;
+
+      // Set optional fields
+      if (note !== null) properties[HS_REFERRAL_PROPS.NOTE] = note;
+      if (outreachStatus !== null) properties[HS_REFERRAL_PROPS.OUTREACH] = outreachStatus;
+      if (clientInterest !== null) properties[HS_REFERRAL_PROPS.INTEREST] = clientInterest;
+      if (previouslySent !== null) properties[HS_REFERRAL_PROPS.PREVIOUSLY_SENT] = previouslySent;
+
+      // Set copied-from fields
+      const currentYear = new Date().getFullYear();
+      let copiedFromDealKey = dealId;
+      let copiedFromYear = currentYear;
+
+      // Try to read from Deal if custom properties are configured
+      if (HS_DEAL_PROPS.KEY || HS_DEAL_PROPS.YEAR) {
+        try {
+          const propsToRead = [];
+          if (HS_DEAL_PROPS.KEY) propsToRead.push(HS_DEAL_PROPS.KEY);
+          if (HS_DEAL_PROPS.YEAR) propsToRead.push(HS_DEAL_PROPS.YEAR);
+
+          const dealData = await readObject(HS_OBJECTS.DEAL_V3, dealId, propsToRead);
+
+          if (HS_DEAL_PROPS.KEY && dealData?.properties?.[HS_DEAL_PROPS.KEY]) {
+            copiedFromDealKey = String(dealData.properties[HS_DEAL_PROPS.KEY]);
+          }
+          if (HS_DEAL_PROPS.YEAR && dealData?.properties?.[HS_DEAL_PROPS.YEAR]) {
+            const yearValue = dealData.properties[HS_DEAL_PROPS.YEAR];
+            copiedFromYear = typeof yearValue === "number" ? yearValue : parseInt(String(yearValue), 10) || currentYear;
+          }
+        } catch {
+          // Use defaults if reading fails
+        }
+      }
+
+      properties[HS_REFERRAL_PROPS.COPIED_FROM_DEAL_KEY] = copiedFromDealKey;
+      properties[HS_REFERRAL_PROPS.COPIED_FROM_YEAR] = copiedFromYear;
+
+      const created: any = await hsPost(`/crm/v3/objects/${encodeURIComponent(HS_OBJECTS.REFERRAL)}`, {
+        properties,
+      });
+
+      referralId = String(created.id);
+
+      // Create associations with proper type IDs
+      await ensureAssociation(HS_OBJECTS.REFERRAL, referralId, HS_OBJECTS.DEAL_V4, dealId);
+      await ensureAssociation(HS_OBJECTS.REFERRAL, referralId, HS_OBJECTS.COMPANY_V4, companyId);
+      if (programId) await ensureAssociation(HS_OBJECTS.REFERRAL, referralId, HS_OBJECTS.PROGRAM, programId);
+      if (sessionId) await ensureAssociation(HS_OBJECTS.REFERRAL, referralId, HS_OBJECTS.SESSION, sessionId);
+    }
+
+    return NextResponse.json({
+      ok: true,
+      referralId,
+      created: !isUpdate,
+      updated: isUpdate,
+    });
+  } catch (e: any) {
+    console.error("Error in POST /api/referrals:", e);
+    return NextResponse.json({ error: e?.message || "Failed to create/update referral" }, { status: 500 });
+  }
+}
diff --git a/referral-builder/vercel-api/src/lib/associations.ts b/referral-builder/vercel-api/src/lib/associations.ts
new file mode 100644
index 0000000..962af89
--- /dev/null
+++ b/referral-builder/vercel-api/src/lib/associations.ts
@@ -0,0 +1,60 @@
+import { hsGet, hsPost, hsPut } from "./hubspot";
+
+const associationTypeCache = new Map<string, number>();
+
+export async function listAssociatedIds(fromType: string, fromId: string, toType: string): Promise<string[]> {
+  const ids: string[] = [];
+  let after: string | null = null;
+
+  while (true) {
+    const qs = new URLSearchParams({ limit: "500" });
+    if (after) qs.set("after", after);
+
+    const path = `/crm/v4/objects/${encodeURIComponent(fromType)}/${encodeURIComponent(fromId)}/associations/${encodeURIComponent(toType)}?${qs.toString()}`;
+    const data: any = await hsGet(path);
+
+    for (const r of data?.results || []) {
+      if (r?.toObjectId != null) ids.push(String(r.toObjectId));
+    }
+
+    after = data?.paging?.next?.after ? String(data.paging.next.after) : null;
+    if (!after) break;
+  }
+
+  return ids;
+}
+
+export async function getAssociationTypeId(fromType: string, toType: string): Promise<number> {
+  const cacheKey = `${fromType}->${toType}`;
+  const cached = associationTypeCache.get(cacheKey);
+  if (cached !== undefined) return cached;
+
+  const path = `/crm/v4/associations/${encodeURIComponent(fromType)}/${encodeURIComponent(toType)}/labels`;
+  const data: any = await hsGet(path);
+
+  const defaultAssoc = data?.results?.find((r: any) => r?.category === "HUBSPOT_DEFINED");
+  const typeId = defaultAssoc?.typeId;
+
+  if (typeId === undefined) {
+    throw new Error(`No default association type found for ${fromType} -> ${toType}`);
+  }
+
+  associationTypeCache.set(cacheKey, typeId);
+  return typeId;
+}
+
+export async function createAssociation(fromType: string, fromId: string, toType: string, toId: string): Promise<void> {
+  const typeId = await getAssociationTypeId(fromType, toType);
+
+  await hsPut(
+    `/crm/v4/objects/${encodeURIComponent(fromType)}/${encodeURIComponent(fromId)}/associations/${encodeURIComponent(toType)}/${encodeURIComponent(toId)}`,
+    [{ associationCategory: "HUBSPOT_DEFINED", associationTypeId: typeId }]
+  );
+}
+
+export async function ensureAssociation(fromType: string, fromId: string, toType: string, toId: string): Promise<void> {
+  const existingIds = await listAssociatedIds(fromType, fromId, toType);
+  if (!existingIds.includes(String(toId))) {
+    await createAssociation(fromType, fromId, toType, toId);
+  }
+}
diff --git a/referral-builder/vercel-api/src/lib/config.ts b/referral-builder/vercel-api/src/lib/config.ts
new file mode 100644
index 0000000..fda87b3
--- /dev/null
+++ b/referral-builder/vercel-api/src/lib/config.ts
@@ -0,0 +1,38 @@
+export const HS_OBJECTS = {
+  // Standard objects: v3 uses plural, v4 uses singular
+  DEAL_V3: "deals",
+  COMPANY_V3: "companies",
+  DEAL_V4: "deal",
+  COMPANY_V4: "company",
+
+  // Custom objects: set these in Vercel env, or use p_{object_name}
+  PROGRAM: process.env.HS_PROGRAM_OBJECT_TYPE || "p_program",
+  SESSION: process.env.HS_SESSION_OBJECT_TYPE || "p_session",
+  REFERRAL: process.env.HS_REFERRAL_OBJECT_TYPE || "p_referral",
+};
+
+// Referral properties (2025.02 schema - adjust via env vars if your internal property names differ)
+export const HS_REFERRAL_PROPS = {
+  // Editable in UI
+  KEY: process.env.HS_REFERRAL_KEY_PROP || "referral_key",
+  OUTREACH: process.env.HS_REFERRAL_OUTREACH_PROP || "referral_status",
+  INTEREST: process.env.HS_REFERRAL_INTEREST_PROP || "client_interest",
+  NOTE: process.env.HS_REFERRAL_NOTE_PROP || "referral_note_to_company",
+  PREVIOUSLY_SENT: process.env.HS_REFERRAL_PREVIOUSLY_SENT_PROP || "previously_sent_to_camp",
+
+  // Auto-managed (not edited in UI)
+  NAME: process.env.HS_REFERRAL_NAME_PROP || "referral_name",
+  COPIED_FROM_DEAL_KEY: process.env.HS_REFERRAL_COPIED_DEAL_KEY_PROP || "copied_from_deal_key",
+  COPIED_FROM_YEAR: process.env.HS_REFERRAL_COPIED_YEAR_PROP || "copied_from_year",
+  EMAIL_SEND_COUNT: process.env.HS_REFERRAL_EMAIL_COUNT_PROP || "email_send_count",
+  EMAIL_LAST_SENT: process.env.HS_REFERRAL_EMAIL_LAST_SENT_PROP || "email_last_sent_datetime",
+};
+
+// Deal properties for copying metadata (optional - defaults to current year and deal ID)
+export const HS_DEAL_PROPS = {
+  KEY: process.env.HS_DEAL_KEY_PROP || null, // If set, read this deal property for copied_from_deal_key
+  YEAR: process.env.HS_DEAL_YEAR_PROP || null, // If set, read this deal property for copied_from_year
+};
+
+// Common display properties (usually safe)
+export const HS_NAME_PROP = "name";
diff --git a/referral-builder/vercel-api/src/lib/hubspot.ts b/referral-builder/vercel-api/src/lib/hubspot.ts
new file mode 100644
index 0000000..5b19e07
--- /dev/null
+++ b/referral-builder/vercel-api/src/lib/hubspot.ts
@@ -0,0 +1,57 @@
+const HS_BASE = "https://api.hubapi.com";
+
+function requireEnv(name: string): string {
+  const v = process.env[name];
+  if (!v) throw new Error(`Missing env var: ${name}`);
+  return v;
+}
+
+async function hubspotRequest<T>(path: string, init: RequestInit = {}): Promise<T> {
+  const token = requireEnv("HUBSPOT_ACCESS_TOKEN");
+  const url = `${HS_BASE}${path}`;
+
+  const headers: Record<string, string> = {
+    Authorization: `Bearer ${token}`,
+    Accept: "application/json",
+  };
+
+  // Only set JSON content-type if we're sending a body
+  const hasBody = Boolean(init.body);
+  if (hasBody) headers["Content-Type"] = "application/json";
+
+  const res = await fetch(url, {
+    ...init,
+    headers: { ...headers, ...(init.headers as any) },
+  });
+
+  const text = await res.text();
+  let data: any = null;
+  try {
+    data = text ? JSON.parse(text) : null;
+  } catch {
+    data = { raw: text };
+  }
+
+  if (!res.ok) {
+    const msg = data?.message || data?.error || text || `HubSpot error ${res.status}`;
+    throw new Error(msg);
+  }
+
+  return data as T;
+}
+
+export async function hsGet<T>(path: string): Promise<T> {
+  return hubspotRequest<T>(path, { method: "GET" });
+}
+
+export async function hsPost<T>(path: string, body: any): Promise<T> {
+  return hubspotRequest<T>(path, { method: "POST", body: JSON.stringify(body) });
+}
+
+export async function hsPatch<T>(path: string, body: any): Promise<T> {
+  return hubspotRequest<T>(path, { method: "PATCH", body: JSON.stringify(body) });
+}
+
+export async function hsPut(path: string, body?: any): Promise<void> {
+  await hubspotRequest(path, { method: "PUT", body: body ? JSON.stringify(body) : undefined });
+}
diff --git a/referral-builder/vercel-api/src/lib/objects.ts b/referral-builder/vercel-api/src/lib/objects.ts
new file mode 100644
index 0000000..7d3c298
--- /dev/null
+++ b/referral-builder/vercel-api/src/lib/objects.ts
@@ -0,0 +1,52 @@
+import { hsPost, hsGet } from "./hubspot";
+
+export async function batchRead(objectType: string, ids: string[], properties?: string[]) {
+  if (!ids.length) return [];
+
+  const body: any = {
+    inputs: ids.map((id) => ({ id: String(id) })),
+  };
+  if (properties?.length) body.properties = properties;
+
+  const data: any = await hsPost(`/crm/v3/objects/${encodeURIComponent(objectType)}/batch/read`, body);
+  return data?.results || [];
+}
+
+export async function searchByProperty(
+  objectType: string,
+  propertyName: string,
+  propertyValue: string,
+  properties?: string[]
+): Promise<any | null> {
+  const body: any = {
+    filterGroups: [
+      {
+        filters: [
+          {
+            propertyName,
+            operator: "EQ",
+            value: propertyValue,
+          },
+        ],
+      },
+    ],
+    properties: properties || [],
+    limit: 1,
+  };
+
+  const data: any = await hsPost(`/crm/v3/objects/${encodeURIComponent(objectType)}/search`, body);
+  const results = data?.results || [];
+  return results[0] || null;
+}
+
+export async function readObject(objectType: string, objectId: string, properties?: string[]): Promise<any> {
+  const qs = new URLSearchParams();
+  if (properties?.length) {
+    for (const prop of properties) {
+      qs.append("properties", prop);
+    }
+  }
+
+  const path = `/crm/v3/objects/${encodeURIComponent(objectType)}/${encodeURIComponent(objectId)}${qs.toString() ? `?${qs.toString()}` : ""}`;
+  return await hsGet(path);
+}
diff --git a/referral-builder/vercel-api/tsconfig.json b/referral-builder/vercel-api/tsconfig.json
new file mode 100644
index 0000000..38da2a5
--- /dev/null
+++ b/referral-builder/vercel-api/tsconfig.json
@@ -0,0 +1,27 @@
+{
+  "compilerOptions": {
+    "target": "ES2020",
+    "lib": ["ES2020", "DOM", "DOM.Iterable"],
+    "jsx": "preserve",
+    "module": "ESNext",
+    "moduleResolution": "bundler",
+    "resolveJsonModule": true,
+    "allowJs": true,
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "forceConsistentCasingInFileNames": true,
+    "noEmit": true,
+    "incremental": true,
+    "plugins": [
+      {
+        "name": "next"
+      }
+    ],
+    "paths": {
+      "@/*": ["./src/*"]
+    }
+  },
+  "include": ["next-env.d.ts", "**/*.ts", "**/*.tsx", ".next/types/**/*.ts"],
+  "exclude": ["node_modules"]
+}
diff --git a/referral-builder/vercel-api/vercel.json b/referral-builder/vercel-api/vercel.json
new file mode 100644
index 0000000..b6c46d0
--- /dev/null
+++ b/referral-builder/vercel-api/vercel.json
@@ -0,0 +1,8 @@
+{
+  "version": 2,
+  "buildCommand": "npm run build",
+  "devCommand": "npm run dev",
+  "installCommand": "npm install",
+  "framework": "nextjs",
+  "outputDirectory": ".next"
+}