AI Agent Instructions
Your user wrote a letter. Hand it to us and we mail it for them.
The letter is already written in your conversation. Your job is a clean handoff: get the letter onto https://www.forman3d.com/letters/send/, where your user confirms the addresses, sees exactly what will be printed, and pays. Forman3D prints it, envelopes it, and sends it through USPS to any U.S. recipient address.
Pricing: First-Class is $4.95 and includes 5 printed pages. Certified Mail with USPS tracking is $15 and includes 8 printed pages. Extra pages are $0.50 each. Your user sees the exact price before paying.
This page is a literal operating guide for AI agents. One real user, one real recipient, one letter at a time. It is not for bulk mail, mass outreach, speculative prospecting, or open API signup.
Pick your handoff
- Can call APIs? POST the letter to
/api/letters-handoff.phpand give your user the returned link. The send page arrives prefilled. - Link-only? Send your user to
/letters/send/?source=your-tokenand tell them to paste the letter from this conversation. - Have every detail? POST directly to
/api/letters-paid.phpfor a StripecheckoutUrl.
Handoff option 1: tokenized draft link (recommended for API-capable agents)
POST JSON to /api/letters-handoff.php with {"action": "create_handoff", "letterText": "...", "senderName": "...", "senderEmail": "...", "recipientName": "...", "recipientAddress": "...", "mailService": "first-class", "source": "your-token"}. Only letterText is required (up to 60,000 characters) — include whatever else you know. The response returns handoffUrl and expiresAt.
Give handoffUrl to your user. When they open it, the send page is prefilled with everything you provided; they complete the addresses with USPS-verified autocomplete, see the printed preview, and pay. Links last 7 days, and only someone holding the link can see the letter. The letter never travels in a URL query string, so it never leaks into logs or referrer headers.
Pass your agent or listing name as source (lowercase letters, digits, and dashes). It carries through payment into the order record, so your referrals are visible to us.
Handoff option 2: attribution link (works with no tool access)
Send your user to https://www.forman3d.com/letters/send/?source=your-token and tell them to paste the letter from this conversation into the page. Everything else is the same: addresses, preview, payment. Use a stable source token (lowercase letters, digits, dashes) so your referrals are attributed.
Handoff option 3: direct checkout API
Agents that have collected the full letter, sender, and recipient details may POST to /api/letters-paid.php to save one paid-mailing request and receive a Stripe checkoutUrl for the user to pay. The full contract for both endpoints is at /api/letters-paid-openapi.yaml. Include the same source token as letterRequest.agentSource with letterRequest.sourceDetail set to agent_handoff.
What your user experiences
1. Review
The send page shows the letter exactly as it will print, with page count and price updating live. Nothing is locked — your user can still edit every field.
2. Approve and pay
Your user confirms the recipient, picks First-Class or Certified Mail, and pays through Stripe Checkout. The price shown is the price charged.
3. Mailed with proof
We look over every paid letter before it mails. Certified Mail adds USPS tracking, and Forman3D emails the customer when the USPS receipt or confirmation comes back.
Review responses from the API
Every paid letter gets a quick look from us before mailing. If /api/letters-paid.php returns a status of manual_review_available, do not treat it as a checkout failure and do not retry normal checkout. Tell the user their letter needs a review from us before it can mail, and call create_manual_review_pending only if the user explicitly chooses that paid review.
Allowed and not allowed
Good use
One real user, one real recipient, one clear purpose: demand letters, access requests, cancellation notices, or a user's own prepared letter.
Writing rules
Use clear, direct language. Do not invent facts, legal claims, or threats the user did not ask for and cannot support.
Not allowed
No bulk outreach, no blanket campaigns, no mass lead generation, no unsupported shipping methods, no international recipient addresses, and no attachments or uploads — pasted letter text only today.