Skip to main content
AhaSend troubleshooting starts with the failed step: DNS verification, authentication, message acceptance or recipient delivery; this FAQ points you to the right checks.

​
Why Is My AhaSend Domain Not Verifying?

Check that the records are saved at the provider serving your current nameservers, with the exact full names, types and values shown in AhaSend. A repeated domain suffix, proxied CNAME or duplicate SPF record can break verification. Use your provider guide, then Check DNS. See domain setup for propagation timing and required records.

​
Why Does the API Return 403 Domain Not Allowed?

The key must belong to the right account and allow the domain in the message’s From address. Check the account ID, verified sender and key scope. A domain-scoped key for example.com does not automatically authorize a different sending domain. Follow send-only key setup and read the actual API error message.

​
Why Is Sending Paused on My Domain?

AhaSend refuses new email from a paused domain. It pauses a domain when too many recent emails from it bounced. Your other domains continue to send. Check the domain page in the dashboard for the reason and the next steps. See paused domains.

​
Why Is Sending Paused on My Account?

AhaSend refuses all new email from a paused account. Each v2 API request that uses an API key of the account gets HTTP 401 with account is paused. SMTP refuses each message with code 521. You can still sign in to the dashboard. The dashboard alert shows the reason and the next steps. AhaSend can also send an email about the pause to the account members. For a sub-account, the members of the parent account also get it. When the parent account is paused, its sub-accounts cannot send. A send request of a sub-account then gets HTTP 403 with Sending is paused on the parent account. Contact the parent account owner., and the sub-account dashboard shows a banner. You cannot lift a pause on your own account. If AhaSend paused it, fix the cause, then reply to the pause email or write to support@ahasend.com. AhaSend support examines the account and lifts the pause. For a sub-account, the parent account can also lift the pause, except a pause for a terms of service violation or for an examination by our team. If the parent account paused it, contact the owner of the parent account. The owner or an Administrator of the parent account can resume a paused sub-account: open the sub-account in Settings > Sub-accounts and click Resume, or call Resume Sub-Account. The parent cannot resume a sub-account that our team paused for a terms of service violation or for an examination; contact support for these. When the parent account is paused, its sub-accounts cannot send until AhaSend support lifts that pause.

​
Why Does SMTP Port 465 Not Work?

AhaSend does not support implicit TLS on port 465. Use the STARTTLS settings on SMTP, then authenticate with an SMTP username and password. An API key is not an SMTP password. If the connection times out before a server greeting, check outbound network access on your host.

​
Why Was My Email Delivered but Not Received?

Delivered means the recipient server accepted the message, not that it placed it in the inbox. Ask the recipient to check spam, quarantine, rules and forwarding. Compare the exact recipient and delivery timestamp with the message log. For repeated issues, examine authentication and sender reputation. A sandbox send is never delivered to a mailbox.

​
Why Is the Message Queued or Deferred?

Queued means accepted for processing; deferred means an attempt hit a temporary problem. Check whether the message was scheduled, read delivery attempts, and look for the affected recipient provider. Let AhaSend continue its attempts rather than sending another copy. See bounces and failures and schedule rules.

​
Why Was a Recipient Suppressed?

A matching suppression stops the send. Look up its reason, sending domain and expiry before changing it. An unsubscribe or complaint is not fixed by deleting the record. See suppression duration and removal guidance.

​
Why Did HTTP 202 Still Include an Error?

The API can accept a request while a recipient entry has status: error. Check every item in the response’s data array and its error details; do not report a complete success based only on HTTP 202. See the send response and Create Message.

​
Why Did a Retry Send a Duplicate?

Use a stable idempotency key with the exact same API payload and within its supported window. A timeout or server error can leave the outcome uncertain. Check your job record and message log before retrying. SMTP does not offer that API header, and a new random key on every retry cannot identify the original job.

​
Why Are Webhooks Missing or Failing Verification?

Check that the endpoint is enabled, subscribed to the needed event and reachable at its final URL. Verify the original request bytes and full raw secret before parsing or changing the body. Do not base64-decode AhaSend secrets. See signature verification, retry behavior and local tests.

​
What Should I Collect Before Asking for Help?

Check the status page. Record the time and timezone, message or job ID, sender domain, affected recipient domain, response status and sanitized error text. Keep keys, SMTP passwords, signing secrets and private message content out of screenshots and tickets. Use the support route for your plan.