# HMU API — Full Reference

> James Tannahill's programmable communication gateway.
> Base URL: https://hmuapi.com (also accessible via https://hitmyapi.com)
> Rate limit: 10 requests per sender per endpoint per 30 days.
> All POST endpoints return: { "success": true, "message_id": "uuid", "auto_response": "..." }

---

## POST /api/pitch
Send a deal, partnership, or investment pitch.
Notification: high-priority email.

Required fields:
- name (string, 1-100 chars)
- email (string, valid email)
- type (enum): "investment" | "partnership" | "acquisition" | "other"
- sector (string, 1-100 chars)
- one_liner (string, 10-500 chars): One-line pitch summary

Optional fields:
- deal_size (string): Deal size in dollars
- deck_url (string, URL): Link to pitch deck
- urgency (enum): "low" | "normal" | "high" (default: "normal")

High-priority trigger: deal_size >= $5M or urgency = "high"

---

## POST /api/meet
Request a meeting.
Notification: high-priority email.

Required fields:
- name (string, 1-100 chars)
- email (string, valid email)
- purpose (string, 10-500 chars)

Optional fields:
- duration (enum): "15" | "30" | "60" minutes (default: "30")
- preferred_date (string): Preferred date
- urgency (enum): "low" | "normal" | "high" | "today" (default: "normal")

High-priority trigger: urgency = "today"

---

## POST /api/ask
Ask a question.

Required fields:
- name (string, 1-100 chars)
- email (string, valid email)
- question (string, 10-2000 chars)

Optional fields:
- context (string, max 1000 chars)

---

## POST /api/intro
Request an introduction to someone in James's network.

Required fields:
- name (string, 1-100 chars)
- email (string, valid email)
- target_person (string, 1-100 chars): Who you want to meet
- reason (string, 10-1000 chars): Why you want the introduction
- relationship_to_you (string, 1-500 chars): How you know James

---

## POST /api/hire
Send a job opportunity.

Required fields:
- name (string, 1-100 chars)
- email (string, valid email)
- company (string, 1-200 chars)
- role (string, 1-200 chars)
- description (string, 20-5000 chars)

Optional fields:
- compensation (string): Compensation range

---

## POST /api/collab
Propose a collaboration.

Required fields:
- name (string, 1-100 chars)
- email (string, valid email)
- project (string, 1-200 chars)
- description (string, 20-5000 chars)

Optional fields:
- timeline (string, max 200 chars)

---

## POST /api/advise
Request advisory, board, or consulting engagement.
Notification: high-priority email.

Required fields:
- name (string, 1-100 chars)
- email (string, valid email)
- type (enum): "advisory" | "board" | "consulting" | "fractional"
- company (string, 1-200 chars)
- area (string, 10-1000 chars): What you need help with

Optional fields:
- compensation (string): Compensation details
- duration (string, max 200 chars): Expected engagement duration

High-priority trigger: type = "board" or type = "fractional"

---

## POST /api/press
Media, podcast, or speaking invitation.

Required fields:
- name (string, 1-100 chars)
- email (string, valid email)
- outlet (string, 1-200 chars): Publication or outlet name
- type (enum): "interview" | "podcast" | "panel" | "keynote" | "article" | "other"
- topic (string, 10-1000 chars)

Optional fields:
- date (string): Event or publish date
- audience_size (string): Estimated audience size

---

## GET /api/status
Returns current availability, projects James is working on, preferred topics, and estimated response time.

## GET /api/preferences
Returns communication guidelines: best times (weekdays 9am-5pm ET), topics open to (investment opportunities, technical collaborations, advisory, interesting questions), topics not open to (cold sales, crypto/NFT, unsolicited recruitment).

## GET /api/office-hours
Returns calendar availability link and booking instructions.

## GET /api
Returns full API documentation including all endpoints, methods, descriptions, rate limits, and field schemas as JSON.

---

## Error responses
- 400: Validation failed — includes field-level errors
- 403: Sender is blocked
- 429: Rate limit exceeded — includes retry_after_seconds

## Priority scoring system
Messages are auto-scored on a point system:
- Whitelisted sender: +50
- Returning sender: +10
- High reputation (>=5 messages): +20
- Endpoint high-priority condition met: +30
- Sector match (healthcare, SaaS, AI, ML, LLM, biotech, pharma, medical): +15
- Urgency high/today: +20
- Urgency low: -10

## About James Tannahill
- Founder & Managing Partner, Plocamium Holdings (private equity)
- Founder, 1nessAgency (healthcare digital marketing)
- Founder, HLTHvrs (HIPAA-compliant AI SaaS for mental health providers)
- Interests: Healthcare, SaaS, private equity, AI/ML, web development
- Location: New York area, ET timezone
- Website: https://jamestannahill.com