docs

Guides

For coding agents

Let Claude, Cursor or Copilot set up emitemail, with rules that keep it safe.

emitemail publishes its docs in a form coding agents read well.

  • /llms.txt is a short plain-text guide to the API.
  • Every page here has a Markdown version. Use Copy page or open /docs/md/<page> and paste it into your assistant.
  • /emit-skill.md is a skill file you can add to an agent so it knows how to use emitemail.

Prompt to try#

Read https://app.emitemail.com/llms.txt and add emitemail to this project to send order confirmation emails. Read the key from the EMIT_API_KEY environment variable. Use an Idempotency-Key for each email.

Rules worth giving your agent#

  • Only send to addresses the user gave you or that belong to the user's own customers. Never guess recipients.
  • Use a fresh Idempotency-Key per logical message and reuse it when retrying.
  • Do not retry 4xx errors other than 409. On 429, stop and tell the user the cap was reached.
  • Never print, log or commit the API key. Read it from the environment.
  • An API key belongs to one brand. Use the key of the brand the project belongs to, and do not reuse one project's key in another.