llms.txt
Compare with other sites' llms.txt files →# coss.com
> One API key and one SDK for transactional and marketing email, inboxes for AI agents, SMS, Verify (one-time codes by SMS or email), Sign (e-signatures), Forms (hosted form endpoints), Scheduling (bookings and calendars), Hooks (webhooks as a service for your own users) and Risk (sign-up, login and payment risk decisions, and rate limiting). These docs are written for people and coding agents alike.
## Reading these docs
- Every page is Markdown at its URL plus `.md`, as linked below (the docs home is https://coss.com/docs/index.md). Fetch the pages you need rather than guessing.
- API reference pages (https://coss.com/docs/api-reference/…) give each operation's method and URL, parameters, request body, responses and errors, with TypeScript, HTTP, Python, Go, Ruby, PHP, Java and .NET examples. The OpenAPI 3.1 document is https://api.coss.com/openapi.json.
- This file lists the guides. API operations have indexes of their own: each product below links its own, and https://coss.com/docs/api-reference/llms.txt has them all.
- https://coss.com/llms-full.txt is every guide in one file (over 1 MB), with one short entry per API operation.
- Claude Code plugin, an Agent Skill for other agents, and the MCP server: https://coss.com/docs/agents.md.
## Adding coss.com to a project
1. **Get a development API key.** In the project's directory, run `npx coss-cli init` and tell the user to expect a browser window: it opens the coss.com dashboard, where they sign in and approve a key for this project (it waits up to 5 minutes). It then writes the key to `.env.local` (Next.js) or `.env` as `COSS_API_KEY`, and installs the `coss` package in JavaScript projects. A key already in that file is kept: check it starts with `coss_test_` (`--force` replaces it). Where no browser can open (over SSH, in a container or a cloud sandbox) it prints a link and waits for a code typed into the terminal, so ask the user to run it there themselves. It writes a short version of these notes into the project's AGENTS.md (`--no-agents` skips that) and prints the one next step for this key, including the drop-in when the project already uses Nodemailer, Better Auth, Auth.js, Laravel, Rails or Django. See https://coss.com/docs/cli.md.
2. **Build and test with that key.** Development keys (`coss_test_…`) work with every API, record every email and SMS with their events and webhooks, and deliver nothing; the simulator addresses and numbers produce bounces, complaints and failures (https://coss.com/docs/environments.md). Never ask for a live key (`coss_live_…`) to develop with: going live (a verified domain, a registered number, a production key) is the user's step, in the dashboard.
3. **Use the SDK.** TypeScript: `import { Coss } from "coss"`; `new Coss()` reads `COSS_API_KEY`. Every method returns `{ data, error }` and never throws for API or network failures, so check `error` (`type`, `code`, `message`, and `hint` when it names the fix); retries are automatic and safe (an `Idempotency-Key` on every POST). See https://coss.com/docs/quickstart.md and https://coss.com/docs/sdk.md. Python, Go, Ruby, PHP, Java and .NET SDKs: https://coss.com/docs/sdks.md. Nodemailer, Better Auth, Auth.js, Laravel, Rails and Django: https://coss.com/docs/integrations.md. An agent that needs its own email address gets one with `coss.inboxes.create()`: mail to it arrives as threads with an `inbox.message.received` webhook, and it replies with `coss.inboxes.messages.reply()` (https://coss.com/docs/inboxes.md).
4. **Receive webhooks.** Verify every request with `verifyWebhook(rawBody, headers, secret)`, which throws on a bad signature (https://coss.com/docs/sdk/webhooks.md; events: https://coss.com/docs/webhooks.md). Locally, `npx coss-cli listen --forward-to localhost:3000/<path>` forwards the environment's events to the handler and writes `COSS_WEBHOOK_SECRET` into the same env file as the key. `npx coss-cli webhooks add <url>` registers an endpoint and writes that secret (replacing a listen secret, so both sign the same way). `npx coss-cli trigger <event type>` sends a sample one. These commands use the CLI's own sign-in (`npx coss-cli login`, approved like `init`) or `COSS_API_KEY` in their environment.
5. **Check what happened.** `npx coss-cli logs tail` follows the environment's API requests and events, and `npx coss-cli emails diagnose <id>` explains a delivery. The MCP server (`npx -y coss-mcp`, https://coss.com/docs/mcp.md) reads a development key from the project env file when its own environment has none. Call `get_setup` before writing send code, and `diagnose_email` to explain a delivery. It also searches these docs, and has tools for marketing, Verify, Sign, Forms, Scheduling, Hooks and Risk; `npx coss-cli --help` lists the same products' commands.
## Docs
### Get started
What coss.com is, your first email, and the keys every product shares.
- [Introduction](https://coss.com/docs/index.md)
- [Quickstart](https://coss.com/docs/quickstart.md)
- [Environments and API keys](https://coss.com/docs/environments.md)
**Migrating**
- [Overview](https://coss.com/docs/migrate.md)
- [From Resend](https://coss.com/docs/migrate/resend.md)
- [From SendGrid](https://coss.com/docs/migrate/sendgrid.md)
- [From Postmark](https://coss.com/docs/migrate/postmark.md)
### Email
Transactional and marketing email from your own domains, and email you receive.
API operations, and a summary of each guide: https://coss.com/docs/email/llms.txt
- [Email](https://coss.com/docs/email.md)
**Sending and receiving**
- [Sending email](https://coss.com/docs/email/sending.md)
- [Templates](https://coss.com/docs/email/templates.md)
- [SMTP](https://coss.com/docs/email/smtp.md)
- [Receiving email](https://coss.com/docs/email/receiving.md)
**Deliverability**
- [Domains](https://coss.com/docs/email/domains.md)
- [Transactional and marketing email](https://coss.com/docs/email/streams.md)
- [Suppressions](https://coss.com/docs/email/suppressions.md)
- [DMARC](https://coss.com/docs/email/dmarc.md)
- [Dedicated IPs](https://coss.com/docs/email/dedicated-ips.md)
- [Brand logos (BIMI)](https://coss.com/docs/email/bimi.md)
- [Email for platforms](https://coss.com/docs/email/subaccounts.md)
**Tracking**
- [Delivery status](https://coss.com/docs/email/delivery.md)
- [Open and click tracking](https://coss.com/docs/email/tracking.md)
- [Content storage](https://coss.com/docs/email/content-storage.md)
**Marketing**
- [Contacts](https://coss.com/docs/email/contacts.md)
- [Audiences and segments](https://coss.com/docs/email/audiences-and-segments.md)
- [Topics and preferences](https://coss.com/docs/email/topics-and-preferences.md)
- [One-click unsubscribe](https://coss.com/docs/email/unsubscribe.md)
- [Broadcasts](https://coss.com/docs/email/broadcasts.md)
### Inboxes
Email addresses for AI agents: conversations kept as threads, replies from the same address.
API operations, and a summary of each guide: https://coss.com/docs/inboxes/llms.txt
- [Inboxes](https://coss.com/docs/inboxes.md)
- [Threads and messages](https://coss.com/docs/inboxes/threads.md)
- [Testing](https://coss.com/docs/inboxes/testing.md)
### SMS
Text messages from your own registered numbers, and the replies they receive.
API operations, and a summary of each guide: https://coss.com/docs/sms/llms.txt
- [SMS](https://coss.com/docs/sms.md)
- [Sending SMS](https://coss.com/docs/sms/sending.md)
- [Numbers and registration](https://coss.com/docs/sms/senders.md)
- [Receiving SMS](https://coss.com/docs/sms/receiving.md)
- [Testing SMS](https://coss.com/docs/sms/testing.md)
- [Countries and pricing](https://coss.com/docs/sms/countries-and-pricing.md)
### Sign
E-signatures in your product: embedded or by email, with an audit trail and a sealed copy.
API operations, and a summary of each guide: https://coss.com/docs/sign/llms.txt
- [Sign](https://coss.com/docs/sign.md)
- [Embedded signing](https://coss.com/docs/sign/embedded-signing.md)
- [Email signing](https://coss.com/docs/sign/email-signing.md)
- [Fields and anchors](https://coss.com/docs/sign/fields-and-anchors.md)
- [Templates](https://coss.com/docs/sign/templates.md)
- [Completion and the audit trail](https://coss.com/docs/sign/completion-and-audit-trail.md)
- [Testing](https://coss.com/docs/sign/testing.md)
### Verify
One-time codes by SMS or email, behind a fraud guard that stops SMS pumping.
API operations, and a summary of each guide: https://coss.com/docs/verify/llms.txt
- [Verify](https://coss.com/docs/verify.md)
- [SMS codes](https://coss.com/docs/verify/sms.md)
- [Email codes](https://coss.com/docs/verify/email.md)
- [Fraud guard](https://coss.com/docs/verify/fraud-guard.md)
- [Testing](https://coss.com/docs/verify/testing.md)
### Forms
Hosted form endpoints for your site, screened by Risk and delivered to webhooks, email and contacts.
API operations, and a summary of each guide: https://coss.com/docs/forms/llms.txt
- [Forms](https://coss.com/docs/forms.md)
- [HTML forms](https://coss.com/docs/forms/html-forms.md)
- [JavaScript](https://coss.com/docs/forms/javascript.md)
- [Hosted pages](https://coss.com/docs/forms/hosted-pages.md)
- [Spam filtering](https://coss.com/docs/forms/spam-filtering.md)
- [Double opt-in](https://coss.com/docs/forms/double-opt-in.md)
- [Destinations](https://coss.com/docs/forms/destinations.md)
- [File uploads](https://coss.com/docs/forms/file-uploads.md)
- [Testing](https://coss.com/docs/forms/testing.md)
### Scheduling
Availability and bookings for your users, from the team behind Cal.com.
API operations, and a summary of each guide: https://coss.com/docs/scheduling/llms.txt
- [Scheduling](https://coss.com/docs/scheduling.md)
- [Hosts and availability](https://coss.com/docs/scheduling/hosts.md)
- [Out of office](https://coss.com/docs/scheduling/out-of-office.md)
- [Holidays](https://coss.com/docs/scheduling/holidays.md)
- [Reassigning](https://coss.com/docs/scheduling/reassigning.md)
- [Calendars](https://coss.com/docs/scheduling/calendars.md)
- [Calendar delegation](https://coss.com/docs/scheduling/delegation.md)
- [Your own OAuth apps](https://coss.com/docs/scheduling/oauth-apps.md)
- [Zoom](https://coss.com/docs/scheduling/zoom.md)
- [Bookings](https://coss.com/docs/scheduling/bookings.md)
- [Pools and groups](https://coss.com/docs/scheduling/pools-and-groups.md)
- [Routing](https://coss.com/docs/scheduling/routing.md)
- [Embedding](https://coss.com/docs/scheduling/embedding.md)
- [Notifications](https://coss.com/docs/scheduling/notifications.md)
- [Reminders](https://coss.com/docs/scheduling/reminders.md)
- [Privacy](https://coss.com/docs/scheduling/privacy.md)
- [Testing](https://coss.com/docs/scheduling/testing.md)
### Hooks
Webhooks as a service: send each event once, and coss.com delivers it to your customers' endpoints.
API operations, and a summary of each guide: https://coss.com/docs/hooks/llms.txt
- [Hooks](https://coss.com/docs/hooks.md)
- [Portal](https://coss.com/docs/hooks/portal.md)
- [Receiving messages](https://coss.com/docs/hooks/receiving.md)
- [Delivery, retries and limits](https://coss.com/docs/hooks/delivery.md)
- [Testing](https://coss.com/docs/hooks/testing.md)
### Risk
Decide whether a sign-up, login, payment or post looks like abuse, and why.
API operations, and a summary of each guide: https://coss.com/docs/risk/llms.txt
**Assessments**
- [Risk assessments](https://coss.com/docs/risk.md)
- [Reasons and scores](https://coss.com/docs/risk/reasons.md)
- [Rules](https://coss.com/docs/risk/rules.md)
- [Settings](https://coss.com/docs/risk/settings.md)
**Signals**
- [Checkouts](https://coss.com/docs/risk/checkout.md)
- [Devices](https://coss.com/docs/risk/devices.md)
- [Content classification](https://coss.com/docs/risk/content.md)
**Building blocks**
- [Email, IP and phone checks](https://coss.com/docs/risk/lookups.md)
- [Rate limiting](https://coss.com/docs/risk/rate-limits.md)
**Review and tuning**
- [Lists, feedback and reviews](https://coss.com/docs/risk/lists-and-feedback.md)
- [Calibration](https://coss.com/docs/risk/calibration.md)
- [Testing](https://coss.com/docs/risk/testing.md)
### Platform
What every product shares: webhooks, logs, members and sign-in, reputation, billing and retention.
API operations, and a summary of each guide: https://coss.com/docs/platform/llms.txt
**Events and logs**
- [Webhooks](https://coss.com/docs/webhooks.md)
- [Logs](https://coss.com/docs/logs.md)
- [Log drains](https://coss.com/docs/log-drains.md)
- [Audit log](https://coss.com/docs/audit-log.md)
**Team and sign-in**
- [Members and roles](https://coss.com/docs/members-and-roles.md)
- [Single sign-on](https://coss.com/docs/sso.md)
- [Directory sync (SCIM)](https://coss.com/docs/scim.md)
- [Two-factor authentication and passkeys](https://coss.com/docs/two-factor.md)
**Reputation**
- [Reputation](https://coss.com/docs/reputation.md)
- [Content screening](https://coss.com/docs/content-screening.md)
**Account**
- [Support](https://coss.com/docs/support.md)
- [Plans and billing](https://coss.com/docs/billing.md)
- [Spend and budgets](https://coss.com/docs/spend.md)
- [Data retention](https://coss.com/docs/data-retention.md)
**Compliance**
- [HIPAA mode](https://coss.com/docs/hipaa.md)
### SDKs and tools
The TypeScript SDK, the SDKs of six more languages, framework integrations, the CLI and the MCP server.
**TypeScript SDK**
- [Overview](https://coss.com/docs/sdk.md)
- [Errors and retries](https://coss.com/docs/sdk/errors.md)
- [Verifying webhooks](https://coss.com/docs/sdk/webhooks.md)
**Other languages**
- [Overview](https://coss.com/docs/sdks.md)
- [Python](https://coss.com/docs/sdks/python.md)
- [Go](https://coss.com/docs/sdks/go.md)
- [Ruby](https://coss.com/docs/sdks/ruby.md)
- [PHP](https://coss.com/docs/sdks/php.md)
- [Java](https://coss.com/docs/sdks/java.md)
- [.NET](https://coss.com/docs/sdks/dotnet.md)
**Integrations**
- [Overview](https://coss.com/docs/integrations.md)
- [Nodemailer](https://coss.com/docs/integrations/nodemailer.md)
- [Better Auth](https://coss.com/docs/integrations/better-auth.md)
- [Auth.js](https://coss.com/docs/integrations/authjs.md)
- [Laravel](https://coss.com/docs/integrations/laravel.md)
- [Rails](https://coss.com/docs/integrations/rails.md)
- [Django](https://coss.com/docs/integrations/django.md)
**CLI and agents**
- [Coding agents](https://coss.com/docs/agents.md)
- [CLI](https://coss.com/docs/cli.md)
- [MCP server](https://coss.com/docs/mcp.md)
### API reference
Every endpoint of the HTTP API, with SDK and HTTP examples you can run.
Every API operation, by product: https://coss.com/docs/api-reference/llms.txt
- [Overview](https://coss.com/docs/api-reference.md)
- [Versioning](https://coss.com/docs/api-reference/versioning.md)
- [Changelog](https://coss.com/docs/api-reference/changelog.md)
- [Errors](https://coss.com/docs/api-reference/errors.md)
- [Rate limits](https://coss.com/docs/api-reference/rate-limits.md)
- [Idempotency](https://coss.com/docs/api-reference/idempotency.md)
- [Tracing](https://coss.com/docs/api-reference/tracing.md)
## Products
- [Email](https://coss.com/products/email.md)
- [Marketing email](https://coss.com/products/marketing-email.md)
- [Inboxes](https://coss.com/products/inboxes.md)
- [Inbound email](https://coss.com/products/inbound-email.md)
- [Email for platforms](https://coss.com/products/subaccounts.md)
- [SMTP relay](https://coss.com/products/smtp.md)
- [SMS](https://coss.com/products/sms.md)
- [Verify](https://coss.com/products/verify.md)
- [Sign](https://coss.com/products/sign.md)
- [Forms](https://coss.com/products/forms.md)
- [Scheduling](https://coss.com/products/scheduling.md)
- [Hooks](https://coss.com/products/hooks.md)
- [Risk](https://coss.com/products/risk.md)
- [Rate limiting](https://coss.com/products/rate-limiting.md)
- [Platform](https://coss.com/products/platform.md)
- [Security](https://coss.com/products/security.md)
- [Coding agents](https://coss.com/products/agents.md)
- [SDKs and tools](https://coss.com/products/sdks.md)
## Solutions
- [AI agents](https://coss.com/solutions/ai-agents.md)
- [SaaS platforms](https://coss.com/solutions/platforms.md)
- [Authentication](https://coss.com/solutions/authentication.md)
- [Notifications](https://coss.com/solutions/notifications.md)
- [Booking](https://coss.com/solutions/booking.md)
- [Phone verification](https://coss.com/solutions/phone-verification.md)
- [Contact forms](https://coss.com/solutions/contact-forms.md)
## Comparisons
- [coss.com vs Resend](https://coss.com/compare/resend.md)
- [coss.com vs SendGrid](https://coss.com/compare/sendgrid.md)
- [coss.com vs Postmark](https://coss.com/compare/postmark.md)
- [coss.com vs Mailgun](https://coss.com/compare/mailgun.md)
- [coss.com vs Amazon SES](https://coss.com/compare/amazon-ses.md)
- [coss.com vs Brevo](https://coss.com/compare/brevo.md)
- [coss.com vs MailerSend](https://coss.com/compare/mailersend.md)
- [coss.com vs Loops](https://coss.com/compare/loops.md)
- [coss.com vs Plivo](https://coss.com/compare/plivo.md)
- [coss.com vs Twilio](https://coss.com/compare/twilio.md)
- [coss.com vs Twilio Verify](https://coss.com/compare/twilio-verify.md)
- [coss.com vs Svix](https://coss.com/compare/svix.md)
- [coss.com vs AgentMail](https://coss.com/compare/agentmail.md)
- [coss.com vs DocuSign](https://coss.com/compare/docusign.md)
- [coss.com vs Formspree](https://coss.com/compare/formspree.md)
- [coss.com vs Nylas Scheduler](https://coss.com/compare/nylas-scheduler.md)
- [coss.com vs Castle](https://coss.com/compare/castle.md)
- [coss.com vs Unkey](https://coss.com/compare/unkey.md)
## Company
- [Pricing](https://coss.com/pricing.md): Plans, usage rates, add-ons and what each plan includes.
- [About](https://coss.com/about.md): What coss.com is and who builds it.
- [Changelog](https://coss.com/changelog/index.md): What shipped, newest first.
## Free tools
- [SMS segment calculator](https://coss.com/products/tools/sms-segment-calculator)
- [Webhook signature verifier](https://coss.com/products/tools/webhook-signature-verifier)
- [DMARC record generator and checker](https://coss.com/products/tools/dmarc-record-checker)
## More from coss.com
- [kloq](https://coss.com/kloq/llms.txt): a React calendar component, with its own llms.txt.
- [Shipyard](https://coss.com/shipyard/docs): coding agents on your own machines, with its own docs.