# HMU API

> HMU API is a multi-tenant inbox platform. Each user gets one URL with structured channels for every type of inbound message — deals, meetings, questions, hiring, press, and more. Messages arrive pre-classified and AI-scored, replacing the unstructured chaos of email.
>
> Email is human-to-human. HMU API is anything-to-human.

## Agent Discovery Flow

1. GET /api/u/:username — discover who this person is, what channels they accept
2. GET /api/u/:username/endpoints — see available channels, required fields, schemas
3. POST /api/u/:username/:endpoint — submit a structured message with the right fields
4. GET /api/status/:token — check if the message was received/viewed/replied

No API key needed. No OAuth. No SDK. Any LLM, agent framework, or automation tool that can make HTTP requests can integrate.

## Sender Verification

First-time senders verify their email before messages are delivered. This prevents spam with fake addresses. Once verified, a sender is trusted across all users on the platform. Verified senders, whitelisted senders, and senders with a trusted reputation score (>= 70) skip verification automatically.

Submissions from unverified senders return HTTP 202 with { "pending_verification": true }. The sender receives an email with a verification link. Once clicked, all pending messages are delivered.

## Base URL
https://hmuapi.com/api
Also accessible via: https://hitmyapi.com (redirects to hmuapi.com)

## Multi-Tenant URL Structure
Each user on the platform has a profile page and API endpoints scoped to their username.

Profile page: https://hmuapi.com/<username>
API base: https://hmuapi.com/api/u/<username>

## POST Endpoints (per user)
Send structured JSON messages. All require `name` and `email` plus endpoint-specific fields.
Rate limit: 10 per sender per endpoint per 30 days.

| Endpoint | Purpose |
|----------|---------|
| POST /api/u/<username>/pitch | Deals, partnerships, investments |
| POST /api/u/<username>/meet | Request a meeting |
| POST /api/u/<username>/ask | Ask a question |
| POST /api/u/<username>/intro | Request an introduction |
| POST /api/u/<username>/hire | Job opportunities |
| POST /api/u/<username>/collab | Propose a collaboration |
| POST /api/u/<username>/advise | Advisory, board, consulting, fractional roles |
| POST /api/u/<username>/press | Media, podcasts, speaking invitations |

## Counter-API: Live Pitch Scoring
Score a message payload before submitting it.

POST /api/u/<username>/score
Required fields: endpoint_slug (string), payload (object), session_id (string)
Returns: { score, breakdown, recommendation }

## GET Endpoints (per user)
| Endpoint | Returns |
|----------|---------|
| GET /api/u/<username> | User profile, available channels, bio |
| GET /api/u/<username>/endpoints | List of active channels with field schemas |
| GET /api/u/<username>/status | Current availability and response time |

## Message Status Tracking
Track the status of a submitted message by token.

GET /api/status/<token>
Returns: { status: "received" | "viewed" | "replied", timestamps }

## Legacy Endpoints (jamestannahill only — 301 redirects)
The bare /api/pitch, /api/meet, etc. routes now 301-redirect to /api/u/jamestannahill/<endpoint>.

## Choosing the right channel
- Investment deals, partnerships, acquisitions → /pitch
- Schedule a call or meeting → /meet
- General questions → /ask
- Connect with someone in their network → /intro
- Job or role opportunities → /hire
- Project partnerships → /collab
- Advisory, board seats, consulting, fractional exec → /advise
- Interviews, podcasts, panels, keynotes, articles → /press

## Priority scoring
Messages are automatically scored. Higher priority = faster response.
Boosts: sector match, returning senders, whitelisted contacts, urgency flags, deal size >= $5M.
Use POST /api/u/<username>/score to get a live score before submitting.

## Example
```
curl -X POST https://hmuapi.com/api/u/jamestannahill/ask \
  -H "Content-Type: application/json" \
  -d '{"name":"Your Name","email":"you@example.com","question":"What are you working on?"}'
```

## Full reference
https://hmuapi.com/llms-full.txt

## Platform creator
James Tannahill — Plocamium Holdings (PE), 1nessAgency (healthcare marketing), HLTHvrs (SaaS)
https://jamestannahill.com