> ## Documentation Index
> Fetch the complete documentation index at: https://ahasend.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> AhaSend stores all message data in the EU. See /facts.
> The API base URL is https://api.ahasend.com. Send the API key in the Authorization: Bearer header. See /api-reference/authentication.
> Use send.ahasend.com for SMTP. Ports 25, 587 and 2525 use STARTTLS. Port 465 is not supported. See /smtp.
> For send-only integrations, create an API Key v2 under Credentials → Add and scope it to messages:send:{your-domain}. See /send-api/credentials and /api-reference/scopes.

# Email API Reference (v2)

> AhaSend's REST API for transactional email: send messages, manage domains, webhooks, routes, and suppressions at api.ahasend.com/v2 with Bearer API keys.

The AhaSend API reference covers sending messages and managing domains, credentials, webhooks and routes, with endpoint parameters and response formats.

This API reference documentation covers all available endpoints, parameters, and responses. For implementation guides and examples, check out our usage documentation.

For SMTP integration, please see

<CardGroup cols={2}>
  <Card title="SMTP Integration guide" icon="envelope" href="/docs/smtp">
    Use our SMTP service for easy email integration
  </Card>
</CardGroup>

## Official SDKs

<CardGroup cols={2}>
  <Card title="Node.js and TypeScript SDK" icon="node-js" href="/docs/guides/nodejs-sdk">
    Install @ahasend/sdk, send a sandbox email and handle each recipient result.
  </Card>

  <Card title="Go SDK" icon="golang" href="/docs/guides/go-sdk">
    Install ahasend-go, send a sandbox email and verify webhook signatures.
  </Card>
</CardGroup>

Choose a [framework or platform guide](/docs/guides) for the full integration, or use the [CLI quickstart](/docs/cli/quickstart) to send from your terminal.

## Features

* [Messages](/docs/api-reference/messages/create-message): send transactional email, schedule it, and inspect delivery results.
* [Templates](/docs/api-reference/templates/create-template): create transactional templates, publish them and restore earlier versions.
* [Campaigns](/docs/api-reference/campaigns/overview): build marketing campaigns and campaign templates, test and send them, and read their results.
* [Contacts](/docs/api-reference/contacts/overview): create, update and delete the contacts of your account.
* [Lists](/docs/api-reference/lists/overview): manage contact lists, add contacts to them and record unsubscribes per list.
* [Domains](/docs/api-reference/domains/create-domain): add domains and check their DNS records.
* [Webhooks](/docs/api-reference/webhooks): receive signed delivery events.
* [Routes](/docs/api-reference/routes): receive inbound email at an HTTP endpoint.
* [Suppressions](/docs/api-reference/suppressions/get-suppressions): manage addresses blocked from sending.
* [Reports](/docs/api-reference/reports/get-deliverability-report): query delivery statistics.
* [Sub-accounts](/docs/api-reference/sub-accounts/overview): manage tenant accounts as a Platform Partner.
* [Idempotency](/docs/api-reference/idempotency): replay stored results on the operations that support it.

## Getting Started

<Steps>
  <Step title="Create Your Account">
    Sign up for a free AhaSend account at [dash.ahasend.com/user/register](https://dash.ahasend.com/user/register)
  </Step>

  <Step title="Generate API Key">
    Once logged in, navigate to [the API Keys page](https://dash.ahasend.com/account/-/settings/api-keys) and create a new API key with the appropriate [scopes](/docs/api-reference/scopes) for your use case
  </Step>

  <Step title="Make Your First Request">
    Use your API key to authenticate and send your first email using our simple REST API
  </Step>
</Steps>

<Note>
  Keep your API keys secure and never expose them in client-side code. Always use server-side implementations for production applications.
</Note>

## Support

Need help getting started? We're here to assist:

<CardGroup cols={2}>
  <Card title="Documentation" icon="book" href="/docs/">
    Comprehensive guides and examples
  </Card>

  <Card title="API Reference" icon="terminal" href="/docs/api-reference">
    Complete endpoint documentation
  </Card>
</CardGroup>

<Note>
  This is AhaSend API v2. We maintain full backwards compatibility - while new endpoints and fields may be added, existing APIs and fields will never be removed or changed in breaking ways.
</Note>

Ready to start sending emails? Check out our [Quick Start Guide](/docs/quickstart) or explore our [Authentication](/docs/api-reference/authentication) documentation.

## Related Guides

* [API authentication](/docs/api-reference/authentication), [Permission scopes](/docs/api-reference/scopes), [Send-only API keys](/docs/send-api/credentials).
* [REST sending guide](/docs/send-api/send-email), [SMTP settings](/docs/smtp), [CLI quickstart](/docs/cli/quickstart).
* [Node.js SDK](/docs/guides/nodejs-sdk), [Go SDK](/docs/guides/go-sdk), [Idempotency rules](/docs/api-reference/idempotency).
* [API errors](/docs/api-reference/errors), [API rate limits](/docs/api-reference/rate-limits), [Suppression durations](/docs/bounces#suppression-duration).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.