Thanks for signing up.
',\n});\n\nconsole.log(email.id); // em_abc123...\nconsole.log(email.status); // pending\n```\n\nAll service methods return resource objects with direct property access -- just like the Stripe SDK.\n\n## Available Services\n\n| Service | Property | Description |\n|---------|----------|-------------|\n| Emails | `emailit.emails` | Send, list, get, cancel, retry emails |\n| Domains | `emailit.domains` | Create, verify, list, manage sending domains |\n| API Keys | `emailit.apiKeys` | Create, list, manage API keys |\n| Audiences | `emailit.audiences` | Create, list, manage audiences |\n| Subscribers | `emailit.subscribers` | Add, list, manage subscribers in audiences |\n| Templates | `emailit.templates` | Create, list, publish email templates |\n| Suppressions | `emailit.suppressions` | Create, list, manage suppressed addresses |\n| Email Verifications | `emailit.emailVerifications` | Verify email addresses |\n| Email Verification Lists | `emailit.emailVerificationLists` | Create, list, get results, export |\n| Webhooks | `emailit.webhooks` | Create, list, manage webhooks |\n| Contacts | `emailit.contacts` | Create, list, manage contacts |\n| Events | `emailit.events` | List and retrieve events |\n\n## Usage\n\n### Emails\n\n#### Send an email\n\n```js\nconst email = await emailit.emails.send({\n from: 'hello@yourdomain.com',\n to: ['user@example.com'],\n subject: 'Hello from Emailit',\n html: 'Please find your invoice attached.
',\n attachments: [\n {\n filename: 'invoice.pdf',\n content: readFileSync('invoice.pdf').toString('base64'),\n content_type: 'application/pdf',\n },\n ],\n});\n```\n\n#### Schedule an email\n\n```js\nconst email = await emailit.emails.send({\n from: 'reminders@yourdomain.com',\n to: 'user@example.com',\n subject: 'Appointment Reminder',\n html: 'Your appointment is tomorrow at 2 PM.
',\n scheduled_at: '2026-01-10T09:00:00Z',\n});\n\nconsole.log(email.status); // scheduled\nconsole.log(email.scheduled_at); // 2026-01-10T09:00:00Z\n```\n\n#### List emails\n\n```js\nconst emails = await emailit.emails.list({ page: 1, limit: 10 });\n\nfor (const email of emails) {\n console.log(`${email.id} — ${email.status}`);\n}\n\nif (emails.hasMore()) {\n // fetch next page\n}\n```\n\n#### Cancel / Retry\n\n```js\nawait emailit.emails.cancel('em_abc123');\nawait emailit.emails.retry('em_abc123');\n```\n\n---\n\n### Domains\n\n```js\n// Create a domain\nconst domain = await emailit.domains.create({\n name: 'example.com',\n track_loads: true,\n track_clicks: true,\n});\nconsole.log(domain.id);\n\n// Verify DNS\nconst verified = await emailit.domains.verify('sd_123');\n\n// List all domains\nconst domains = await emailit.domains.list();\n\n// Get a domain\nconst d = await emailit.domains.get('sd_123');\n\n// Update a domain\nawait emailit.domains.update('sd_123', { track_clicks: false });\n\n// Delete a domain\nawait emailit.domains.delete('sd_123');\n```\n\n---\n\n### API Keys\n\n```js\n// Create an API key\nconst key = await emailit.apiKeys.create({\n name: 'Production Key',\n scope: 'full',\n});\nconsole.log(key.key); // only available on create\n\n// List all API keys\nconst keys = await emailit.apiKeys.list();\n\n// Get an API key\nconst k = await emailit.apiKeys.get('ak_123');\n\n// Update an API key\nawait emailit.apiKeys.update('ak_123', { name: 'Renamed Key' });\n\n// Delete an API key\nawait emailit.apiKeys.delete('ak_123');\n```\n\n---\n\n### Audiences\n\n```js\n// Create an audience\nconst audience = await emailit.audiences.create({ name: 'Newsletter' });\nconsole.log(audience.id);\nconsole.log(audience.token);\n\n// List audiences\nconst audiences = await emailit.audiences.list();\n\n// Get an audience\nconst a = await emailit.audiences.get('aud_123');\n\n// Update an audience\nawait emailit.audiences.update('aud_123', { name: 'Updated Newsletter' });\n\n// Delete an audience\nawait emailit.audiences.delete('aud_123');\n```\n\n---\n\n### Subscribers\n\nSubscribers belong to an audience, so the audience ID is always the first argument.\n\n```js\n// Add a subscriber\nconst subscriber = await emailit.subscribers.create('aud_123', {\n email: 'user@example.com',\n first_name: 'John',\n last_name: 'Doe',\n});\n\n// List subscribers in an audience\nconst subscribers = await emailit.subscribers.list('aud_123');\n\n// Get a subscriber\nconst s = await emailit.subscribers.get('aud_123', 'sub_456');\n\n// Update a subscriber\nawait emailit.subscribers.update('aud_123', 'sub_456', {\n first_name: 'Jane',\n});\n\n// Delete a subscriber\nawait emailit.subscribers.delete('aud_123', 'sub_456');\n```\n\n---\n\n### Templates\n\n```js\n// Create a template\nconst template = await emailit.templates.create({\n name: 'Welcome',\n subject: 'Welcome!',\n html: '