# Nuntly

## Docs

- [Retrieve Agent Memory](https://nuntly.com/docs/api-reference/agents/retrieve-agent-memory.md): Retrieve the memory for an AI agent.
- [Upsert Agent Memory](https://nuntly.com/docs/api-reference/agents/upsert-agent-memory.md): Create or update the memory for an AI agent.
- [Create API Key](https://nuntly.com/docs/api-reference/api-keys/create-api-key.md): Generate a new API key. The key value is only returned once — store it securely.
- [Delete API Key](https://nuntly.com/docs/api-reference/api-keys/delete-api-key.md): Revoke an API key. Requests authenticating with this key will be rejected immediately.
- [List API Keys](https://nuntly.com/docs/api-reference/api-keys/list-api-keys.md): Returns all API keys for the organization. Key values are never included in list responses.
- [Retrieve API Key](https://nuntly.com/docs/api-reference/api-keys/retrieve-api-key.md): Returns API key metadata. The key value is never returned after creation.
- [Update API Key](https://nuntly.com/docs/api-reference/api-keys/update-api-key.md): Update the key name, permissions, or restrict it to specific sending domains.
- [Authentication](https://nuntly.com/docs/api-reference/authentication.md): Learn how to authenticate your requests to the Nuntly API.
- [Create Domain](https://nuntly.com/docs/api-reference/domains/create-domain.md): Add a domain to start configuring DNS records for sending or receiving emails.
- [Delete Domain](https://nuntly.com/docs/api-reference/domains/delete-domain.md): Remove a domain from the organization. Cannot be deleted if it has active sending or receiving.
- [List Domains](https://nuntly.com/docs/api-reference/domains/list-domains.md): Returns all domains with their verification and capability status.
- [Retrieve Domain](https://nuntly.com/docs/api-reference/domains/retrieve-domain.md): Returns a domain with its DNS record configuration and current verification status for each record.
- [Update Domain](https://nuntly.com/docs/api-reference/domains/update-domain.md): Toggle sending, receiving, open tracking, or click tracking capabilities for a domain.
- [Cancel Email](https://nuntly.com/docs/api-reference/emails/cancel-email.md): Cancel a scheduled email before delivery. Only emails with `scheduled` status can be cancelled.
- [List Emails](https://nuntly.com/docs/api-reference/emails/list-emails.md): Returns sent emails ordered by submission date, newest first.
- [Retrieve Bulk Emails](https://nuntly.com/docs/api-reference/emails/retrieve-bulk-emails.md): Returns the delivery status of all emails submitted in a bulk request.
- [Retrieve Email](https://nuntly.com/docs/api-reference/emails/retrieve-email.md): Returns an email with its current delivery status and metadata.
- [Retrieve Email Content](https://nuntly.com/docs/api-reference/emails/retrieve-email-content.md): Returns presigned URLs to download the HTML, plain-text, and raw MIME source of a sent email.
- [Retrieve Email Events](https://nuntly.com/docs/api-reference/emails/retrieve-email-events.md): Returns the full delivery event history for an email (sent, delivered, opened, bounced, etc.).
- [Retrieve Email Statistics](https://nuntly.com/docs/api-reference/emails/retrieve-email-statistics.md): Returns aggregated daily sending statistics for the current period.
- [Send Bulk Emails](https://nuntly.com/docs/api-reference/emails/send-bulk-emails.md): Send up to 100 emails in a single request. Use `fallback` to set default values shared across all messages.
- [Send Email](https://nuntly.com/docs/api-reference/emails/send-email.md): Send transactional emails through Nuntly platform. It supports HTML and plain-text emails, attachments, labels, custom headers and scheduling.
- [Errors](https://nuntly.com/docs/api-reference/errors.md): Learn how to handle errors effectively when interacting with the API
- [Create Inbox](https://nuntly.com/docs/api-reference/inboxes/create-inbox.md): Create a new inbox on a verified domain.
- [Delete Inbox](https://nuntly.com/docs/api-reference/inboxes/delete-inbox.md): Soft-delete an inbox.
- [List Inboxes](https://nuntly.com/docs/api-reference/inboxes/list-inboxes.md): List all inboxes.
- [Retrieve Inbox](https://nuntly.com/docs/api-reference/inboxes/retrieve-inbox.md): Retrieve an inbox with thread stats.
- [Send Message](https://nuntly.com/docs/api-reference/inboxes/send-message.md): Send a new message from an inbox.
- [Update Inbox](https://nuntly.com/docs/api-reference/inboxes/update-inbox.md): Update an inbox.
- [Introduction](https://nuntly.com/docs/api-reference/introduction.md): Get started with the API reference documentation for the Nuntly API.
- [Limits](https://nuntly.com/docs/api-reference/limits.md): Understand the size limits applied to emails and API requests.
- [Forward Message](https://nuntly.com/docs/api-reference/messages/forward-message.md): Forward a message to new recipients.
- [List Attachments](https://nuntly.com/docs/api-reference/messages/list-attachments.md): List all attachments for a message.
- [List Messages](https://nuntly.com/docs/api-reference/messages/list-messages.md): List all received messages across inboxes.
- [Reply to Message](https://nuntly.com/docs/api-reference/messages/reply-to-message.md): Reply to a message. Set replyAll to true to reply to all recipients.
- [Retrieve Attachment](https://nuntly.com/docs/api-reference/messages/retrieve-attachment.md): Retrieve an attachment with a presigned download URL.
- [Retrieve Message](https://nuntly.com/docs/api-reference/messages/retrieve-message.md): Retrieve a single message with inbox enrichment.
- [Retrieve Message Content](https://nuntly.com/docs/api-reference/messages/retrieve-message-content.md): Returns presigned URLs to download the HTML, plain-text, and raw MIME source of a received message.
- [Update Message](https://nuntly.com/docs/api-reference/messages/update-message.md): Update message labels. Only available for messages in user-created inboxes.
- [Create Namespace](https://nuntly.com/docs/api-reference/namespaces/create-namespace.md): Create a new namespace.
- [Delete Namespace](https://nuntly.com/docs/api-reference/namespaces/delete-namespace.md): Soft-delete a namespace. Rejects if it has active inboxes.
- [List Namespace Inboxes](https://nuntly.com/docs/api-reference/namespaces/list-namespace-inboxes.md): List inboxes in a namespace.
- [List Namespaces](https://nuntly.com/docs/api-reference/namespaces/list-namespaces.md): List all namespaces.
- [Retrieve Namespace](https://nuntly.com/docs/api-reference/namespaces/retrieve-namespace.md): Retrieve a namespace with inbox stats.
- [Update Namespace](https://nuntly.com/docs/api-reference/namespaces/update-namespace.md): Update a namespace.
- [Retrieve Organization](https://nuntly.com/docs/api-reference/organizations/retrieve-organization.md): Returns the organization's profile, plan, region, and account status.
- [Retrieve Organization Usage](https://nuntly.com/docs/api-reference/organizations/retrieve-organization-usage.md): Returns current period usage metrics (daily and monthly) for sending and receiving, against your plan limits.
- [Retrieve Organizations](https://nuntly.com/docs/api-reference/organizations/retrieve-organizations.md): Returns all organizations the authenticated user belongs to.
- [Rate limits](https://nuntly.com/docs/api-reference/rate-limits.md): Understand the rate limits applied to API requests.
- [SDKs](https://nuntly.com/docs/api-reference/sdks.md): The official Nuntly SDKs for easier API integration
- [List Thread Messages](https://nuntly.com/docs/api-reference/threads/list-thread-messages.md): List messages in a thread (chronological order).
- [List Threads](https://nuntly.com/docs/api-reference/threads/list-threads.md): List threads in an inbox.
- [Retrieve Thread](https://nuntly.com/docs/api-reference/threads/retrieve-thread.md): Retrieve a thread. Pass ?markRead=true to automatically remove the unread label from all messages.
- [Update Thread](https://nuntly.com/docs/api-reference/threads/update-thread.md): Update thread labels and agent assignment. Label operations apply to all messages in the thread.
- [List Webhook Event Deliveries](https://nuntly.com/docs/api-reference/webhooks-events/list-webhook-event-deliveries.md): Returns all delivery attempts for a webhook event, including HTTP status codes and response times.
- [List Webhook Events](https://nuntly.com/docs/api-reference/webhooks-events/list-webhook-events.md): Returns recent webhook events across all registered endpoints.
- [Replay Webhook Event](https://nuntly.com/docs/api-reference/webhooks-events/replay-webhook-event.md): Re-deliver a webhook event to its endpoint. Useful for retrying failed deliveries.
- [Webhook endpoint](https://nuntly.com/docs/api-reference/webhooks-hook/webhook-endpoint.md): Endpoint to receive webhook events.
- [Create Webhook](https://nuntly.com/docs/api-reference/webhooks/create-webhook.md): Register an endpoint to start receiving webhook events for your organization.
- [Delete Webhook](https://nuntly.com/docs/api-reference/webhooks/delete-webhook.md): Remove a webhook endpoint. No further events will be delivered to this URL.
- [List Webhooks](https://nuntly.com/docs/api-reference/webhooks/list-webhooks.md): Returns all registered webhook endpoints for the organization.
- [Retrieve Webhook](https://nuntly.com/docs/api-reference/webhooks/retrieve-webhook.md): Returns a webhook endpoint with its URL, subscribed events, and configuration.
- [Update Webhook](https://nuntly.com/docs/api-reference/webhooks/update-webhook.md): Update the endpoint URL, subscribed event types, or rotate the signing secret.
- [Create Your Account](https://nuntly.com/docs/guides/account-setup.md): Learn how to create a Nuntly account, verify your email, sign in with email or social auth, and enable two-factor authentication.
- [Generate your API key](https://nuntly.com/docs/guides/api-keys.md): Learn how to create and manage Nuntly API keys. Use your key to authenticate REST API requests, SDK calls, and SMTP connections.
- [Better Email for Better Auth](https://nuntly.com/docs/guides/better-email-for-better-auth.md): Centralize Better Auth email management with a unified plugin for all authentication email types
- [Bulk Email Sending](https://nuntly.com/docs/guides/bulk-email-sending.md): Learn how to send bulk emails using the Nuntly API. Send multiple emails in a single request with the bulk send method and fallback properties.
- [Get Up and Running](https://nuntly.com/docs/guides/getting-started.md): Follow the three-step onboarding in the Nuntly dashboard - create an API key, send your first email, and set up your account.
- [Idempotency keys](https://nuntly.com/docs/guides/idempotency.md): Prevent duplicate email sends by using idempotency keys. Safely retry API requests without risk of sending the same email twice.
- [Handle Webhook Events](https://nuntly.com/docs/guides/integrate-webhooks.md): Implement an HTTPS endpoint to receive and verify Nuntly webhook events. Includes Next.js and Express code examples with signature verification.
- [Observability overview](https://nuntly.com/docs/guides/observability.md): Visualize and monitor your Nuntly metrics and event logs in real time. Track API performance, email delivery, webhook events, and received messages.
- [API observability](https://nuntly.com/docs/guides/observability-api.md): Monitor your API request volume, response times, and a live log of every call made to Nuntly.
- [Events observability](https://nuntly.com/docs/guides/observability-events.md): Track all email events across your organization — deliveries, bounces, opens, clicks, complaints, and more.
- [Receiving observability](https://nuntly.com/docs/guides/observability-receiving.md): Monitor received message volume, security check results, and top recipients across your receiving domains.
- [Sending observability](https://nuntly.com/docs/guides/observability-sending.md): Track your email delivery performance — delivery rates, bounce rates, complaint rates, and email flow visualization.
- [Webhooks observability](https://nuntly.com/docs/guides/observability-webhooks.md): Monitor webhook delivery status and troubleshoot failed deliveries to your endpoint.
- [AI agent inboxes](https://nuntly.com/docs/guides/receiving-agents.md): Build AI agents that receive, process, and respond to emails. Understand how agent inboxes work, manage conversation memory, and see a complete example with the Claude API.
- [Inboxes](https://nuntly.com/docs/guides/receiving-inboxes.md): Create and manage inboxes to route incoming emails.
- [Messages](https://nuntly.com/docs/guides/receiving-messages.md): List, retrieve, and inspect received messages. Access message content, headers, and attachments through the API.
- [Namespaces](https://nuntly.com/docs/guides/receiving-namespaces.md): Organize inboxes into namespaces for isolation and multi-tenant grouping. Understand when to use namespaces, common patterns, and how to map your internal IDs.
- [Receiving overview](https://nuntly.com/docs/guides/receiving-overview.md): Learn how to receive emails on your verified domains. Understand the processing pipeline, key concepts, and common patterns for support inboxes, AI agents, multi-tenant SaaS, and email automation.
- [Send, reply, and forward](https://nuntly.com/docs/guides/receiving-send-reply.md): Send new emails, reply to messages, reply all, and forward messages from your inboxes.
- [Set up receiving](https://nuntly.com/docs/guides/receiving-setup.md): Enable email receiving on your domain. Configure MX records, verify DNS propagation, and start receiving emails.
- [Threads](https://nuntly.com/docs/guides/receiving-threads.md): Understand how received emails are grouped into conversation threads. List, retrieve, and manage threads.
- [Receiving events](https://nuntly.com/docs/guides/receiving-webhooks.md): Subscribe to receiving events. Receive real-time notifications when messages arrive, security issues are detected, or agents are triggered.
- [SDK Setup](https://nuntly.com/docs/guides/requirements.md): Set up the Nuntly TypeScript SDK. Install the package, initialize with your API key, and start sending emails from Node.js or Bun.
- [Send Emails with SMTP](https://nuntly.com/docs/guides/send-emails-with-smtp.md): Learn how to send emails using Nuntly's SMTP server with your favorite email clients and libraries.
- [Send Your First Email](https://nuntly.com/docs/guides/send-your-first-email.md): Learn how to send your first transactional email using the Nuntly API. Includes examples for HTML, plain text, and combined email messages.
- [Add a Sending Domain](https://nuntly.com/docs/guides/sending-domains.md): Learn how to add a sending domain in Nuntly. Configure DKIM, SPF, DMARC, and MX DNS records, import a zone file, and enable open and click tracking.
- [Sending events](https://nuntly.com/docs/guides/sending-webhooks.md): Subscribe to sending events. Receive real-time notifications when emails are delivered, bounced, opened, clicked, or encounter issues.
- [Set Up Webhooks](https://nuntly.com/docs/guides/webhooks.md): Learn how to create and manage Nuntly webhooks. Subscribe to email events like delivery, bounces, opens, and clicks with a single endpoint.
- [Welcome to Nuntly](https://nuntly.com/docs/index.md): Nuntly is a developer-first email platform. Send transactional emails via API or SMTP, set up webhooks, and monitor delivery in real time.

## OpenAPI Specs

- [openapi.documented](https://nuntly.com/docs/openapi.documented.yml)
- [openapi](https://nuntly.com/docs/api-reference/openapi.json)

## Optional

- [Documentation](https://nuntly.com/docs)
- [Blog](https://nuntly.com/blog)