Welcome to {{company}}.
',\n variables: ['firstName', 'company'],\n});\n\n// Send to one person\nawait outbound.templates.send({\n templateId: template.id,\n toEmail: 'user@example.com',\n fromEmail: 'noreply@yourcompany.com',\n variables: { firstName: 'John', company: 'Acme' },\n});\n\n// Send to many people\nawait outbound.templates.bulkSend({\n templateId: template.id,\n fromEmail: 'noreply@yourcompany.com',\n recipients: [\n { toEmail: 'alice@example.com', variables: { firstName: 'Alice', company: 'Acme' } },\n { toEmail: 'bob@example.com', variables: { firstName: 'Bob', company: 'Acme' } },\n ],\n});\n```\n\n### 6. Multi-tenant usage\n\nThe SDK supports multi-tenant applications. You can override the API key on any individual call using the optional last argument:\n\n```ts\nconst outbound = new Outbound(); // no default apiKey\n\nconst tenantAKey = 'mu_outbound_tenant_a_...';\nconst tenantBKey = 'mu_outbound_tenant_b_...';\n\n// Pass { apiKey } as the last argument to override per call\nawait outbound.email.send({ /* ... */ }, { apiKey: tenantAKey });\nawait outbound.email.send({ /* ... */ }, { apiKey: tenantBKey });\n```\n\nYou can also set a default in the constructor and override only when needed:\n\n```ts\nconst outbound = new Outbound({ apiKey: tenantAKey }); // default\n\nawait outbound.email.send({ /* ... */ }); // uses tenantAKey\nawait outbound.email.send({ /* ... */ }, { apiKey: tenantBKey }); // uses tenantBKey\n```\n\n## Key Concepts\n\n### Email Lifecycle\n\nEvery email goes through these statuses:\n\n```\nqueued → processing → sent → delivered\n ↘ bounced\n ↘ complained\n delivered → opened → clicked\n```\n\n| Status | Meaning |\n|--------|---------|\n| `queued` | Email is in the queue, waiting to be processed |\n| `processing` | Email is being sent to AWS SES |\n| `sent` | SES accepted the email |\n| `delivered` | Email landed in recipient's inbox |\n| `bounced` | Email bounced (bad address or mailbox full) |\n| `complained` | Recipient marked it as spam |\n| `opened` | Recipient opened the email (requires tracking) |\n| `clicked` | Recipient clicked a link (requires tracking) |\n| `failed` | Failed to send (SES rejection or error) |\n\n### Suppression List\n\nThe platform automatically suppresses emails that bounce or receive complaints. You can also manually suppress emails. Any future send to a suppressed address is **silently filtered out** — it won't count against your quota.\n\n### Quotas\n\nYour tenant account has:\n- **Daily limit** — Max emails per day\n- **Monthly limit** — Max emails per month\n- **Rate limit** — Max emails per second\n- **Template limit** — Max number of templates\n\nCheck your quota anytime with `outbound.dashboard.quota()`.\n\n## What's Next?\n\n- [Configuration](/guide/configuration) — Customize timeouts, retries, and more\n- [Error Handling](/guide/error-handling) — Handle every error type\n- [Email API](/api/email) — Single and bulk sending reference\n- [Templates API](/api/templates) — Full template lifecycle\n- [Webhooks API](/api/webhooks) — Real-time event notifications\n\n## License\n\nMIT\n","readmeFilename":"README.md"}