# Signbee
> Send documents for e-signing via a single API call. Built for AI agents.

## Install as a skill
npx skills add signbee/skill --skill signbee -g

## API
- POST /api/v1/send: Send a document for signing (markdown → PDF → both parties sign)

## Authentication
- Optional: Use `Authorization: Bearer <api_key>` for instant sender verification.
- Without API key: Sender verifies via email OTP before the document reaches the recipient.
- Get an API key at https://signb.ee/dashboard

## Send a document
POST https://signb.ee/api/v1/send
Content-Type: application/json
Authorization: Bearer <api_key> (optional)

Required fields:
- markdown: Document content in markdown format (min 10 chars, max 50KB)
- sender_name: Full name of the sender
- sender_email: Email address of the sender
- recipient_name: Full name of the recipient
- recipient_email: Email address of the recipient

Optional fields:
- title: Document title (auto-extracted from first heading if omitted)
- pdf_url: URL to an existing PDF (skips markdown-to-PDF conversion)
- expires_in_days: Days until signing link expires (default: 7)

### Example request
{"markdown": "# Mutual NDA\n\nThis agreement is between the undersigned parties.\n\n## Terms\n\n1. Both parties agree to keep shared information confidential.\n2. This agreement remains in effect for 2 years from the date of signing.\n3. Neither party shall disclose proprietary information without written consent.", "sender_name": "Alice Chen", "sender_email": "alice@startup.com", "recipient_name": "Bob Smith", "recipient_email": "bob@acme.com", "title": "Mutual NDA"}

### Response (with API key)
{"document_id": "cmm...", "status": "pending_recipient", "sender": "Alice Chen", "recipient": "Bob Smith", "expires_at": "2026-03-19T12:00:00.000Z"}

### Response (without API key)
{"document_id": "cmm...", "status": "pending_sender", "message": "Verification email sent to alice@startup.com. Complete setup to send the document."}

## Flow
1. Agent calls POST /api/v1/send with document content and party details
2. With API key: sender is pre-verified, recipient gets signing email immediately
3. Without API key: sender verifies via OTP, sets up account + signature, then recipient gets signing email
4. Recipient clicks link, reviews document (sees sender's signature), signs
5. Both parties receive the signed PDF with SHA-256 certificate via email

## Plan limits
- Free: 5 documents/month
- Pro ($9/mo): 100 documents/month
- Business ($19/mo): Unlimited
- Upgrade at https://signb.ee/dashboard

## Notes
- Markdown supports headings, lists, tables, code blocks, blockquotes
- Every signed document includes a tamper-proof SHA-256 signing certificate
- Signbee handles all email delivery — no webhooks or polling needed