HR & People

Offer Letter

Formal job offer — role, compensation block, benefits, contingencies, and acceptance signature.

The contract

Fields your API call provides. Amounts and totals are always computed by the caller — templates only format.

signer.name	string	required
signer.title	string	required
company.name	string	required
company.address	string	required
benefits[].text	string	required
position.team	string	required
position.title	string	required
position.manager	string	required
candidate.name	string	required
expires_on	string	required
offer_date	string	required
start_date	string	required
compensation.bonus	string	required
compensation.equity	string	required
compensation.base_salary	number	required
contingencies	string	required

MCP-ready: forks of this template will expose generate_offer_letter when the MCP server ships.

Generate it (after you fork & publish)

curl -X POST https://your-paperbrain-host/api/generate/gen_<your-id> \
  -H "Content-Type: application/json" \
  -d '{
    "signer": {
      "name": "Aisha Karim",
      "title": "VP Engineering"
    },
    "company": {
      "name": "Lumen Labs",
      "address": "550 Mission Street, Floor 12, San Francisco, CA 94105"
    },
    "benefits": [
      {
        "text": "Medical, dental, and vision (100% premium covered for you, 75% for dependents)"
      },
      {
        "text": "401(k) with 4% match"
      },
      {
        "text": "20 days PTO plus company holidays"
      },
      {
        "text": "$1,500 annual learning budget"
      }
    ],
    "position": {
      "team": "Platform",
      "title": "Senior Product Engineer",
      "manager": "Aisha Karim, VP Engineering"
    },
    "candidate": {
      "name": "Jordan Reyes"
    },
    "expires_on": "2026-06-17",
    "offer_date": "2026-06-10",
    "start_date": "2026-07-13",
    "compensation": {
      "bonus": "10% annual target",
      "equity": "8,000 stock options, 4-year vest with 1-year cliff",
      "base_salary": 198000
    },
    "contingencies": "successful reference and background checks"
  }'

gen_<your-id>is your generator's id once you fork and publish. The body shown is this template's sample data — the exact shape the contract validates.