AI Agent Instructions
Use this service to help one user prepare one real mailed letter.
Start on the main letters page. Help the user choose a template, complete the sender and recipient details, edit the letter, and then choose free download / print, $10 paid first-class mailing, or Certified Mail for $19 total.
Current scope: recipient mailing addresses must be in the United States. The sender or customer can be outside the U.S., including expats who need a letter mailed back home.
This page is a literal operating guide for AI agents. It is not for bulk mail, mass outreach, speculative prospecting, or open API signup.
Required fields
- Sender full name
- Sender mailing address
- Sender email
- Recipient name and mailing address
- Full letter text
- Mail service: first-class or Certified Mail
- U.S. addresses only
Exact workflow
1. Start in the builder
Open /letters/, choose the closest template, and help the user edit the letter so it matches their actual situation.
2. Fill the required fields
Make sure sender name, sender mailing or return address, sender email, recipient name, recipient U.S. mailing address, and the full letter body are complete and readable. Do not use this flow for non-U.S. recipient addresses.
3. Let the user choose
The user can either download and print the letter for free, choose the $10 first-class mailing option, or choose Certified Mail for $19 total.
Free path
Use the builder, then choose the free download / print option. That gives the user a printable HTML copy they can save, print, or mail on their own.
Paid mailing path
Use the same draft, choose the paid mailing option, let the site save the letter as a local Forman3D order, complete payment through Stripe Checkout, and then return to the standard thank-you page. Certified Mail is available as a $9 add-on. Certified proof comes back to Forman3D, and Forman3D emails the customer when the USPS receipt or confirmation is received.
Programmatic paid-mailing handoff
AI tools that can call APIs may use POST /api/letters-paid.php to save one paid-mailing request and receive a Stripe checkoutUrl. Give that URL to the user so they can complete payment in Stripe Checkout. The OpenAPI contract is available at /api/letters-paid-openapi.yaml.
This API is only for one real user, one real recipient, and one mailed letter to a U.S. recipient address at a time. Set mailService to certified only when the user chooses the Certified Mail add-on.
Agent/API submissions do not receive the assistive mail-readiness review. The paid request endpoint runs Forman3D's protective gate before normal checkout. If the API returns manual_review_available, do not treat that as a checkout failure and do not retry normal checkout. Tell the user the draft needs review before mailing, then call create_manual_review_pending only if the user explicitly chooses paid manual 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 mail, and no attachment/upload promises yet. Attachments are planned as a future $1/page add-on.