Skip to content

Docs: what inbound messages AhaSend rejects (routing troubleshooting) #40

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
MarkNLD merged 3 commits into from
Oct 21, 2026
Merged

Docs: what inbound messages AhaSend rejects (routing troubleshooting) #40

Changes from all commits
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
4a81fa5
Docs: which inbound messages AhaSend rejects (routing)
MarkNLD Oct 21, 2026
a69ddf5
Docs: inbound rejections as a troubleshooting accordion instead of a …
MarkNLD Oct 21, 2026
ec5a099
Docs: rename rejection accordion
MarkNLD Oct 21, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
17 changes: 17 additions & 0 deletions integrations/routing.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -756,6 +756,23 @@ The workflow functions below use application-owned callbacks such as `createSupp
```
</Accordion>

<Accordion title="What Messages Does AhaSend Reject?" icon="ban">
AhaSend checks every message that arrives at `mx.ahasend.com` before it is queued for your route. A message that fails a check is refused during the SMTP transaction with a permanent error, so the sender's server returns it as a bounce and nothing reaches your endpoint. The bounce text quotes our reply:

| Check | SMTP reply | What it means |
|---|---|---|
| Neither domain is ours | `556` | No AhaSend account owns the recipient's domain or the sender's domain. Usually a typo in the address, or a domain whose MX points to AhaSend without being added to an account. |
| Not exactly one `From` address | `550` | The message has no `From` header, or more than one address in it. |
| Fails the sender's DMARC policy | `550` | The `From` domain publishes `p=reject` or `p=quarantine`, and neither SPF nor DKIM aligns with that domain. |
| No SPF or DKIM pass | `550` | The `From` domain has no DMARC record, or one with `p=none`, and the message has neither a passing SPF result nor a valid DKIM signature for any domain. |
| Bare line endings | `552` | Lines end in LF instead of CRLF, which the SMTP standard requires. Typical of a script that writes the message by hand. |
| Larger than 20 MiB | `552` | The whole message, attachments included after base64 encoding. See [SMTP limits](/smtp). |

The authentication checks keep forged mail out of your application: a message that passes was sent by a server the `From` domain authorizes. A sender whose domain has no SPF, no DKIM and no DMARC is refused; they need at least SPF or DKIM, which Gmail and Microsoft require of them anyway.

A rejected message is not stored and does not appear in your message log; the sender's bounce is the only record.
</Accordion>

<Accordion title="Route Disabled" icon="ban">
**Automatic Route Disabling:**
- AhaSend disables routes after more than 100 consecutive failed attempts
Expand Down
Loading