Suppression list
A suppression is an address Hiveku will not send to, even when you ask it to. Sending again and again to addresses that bounce or complain is the fastest way to hurt your domain’s reputation, so Hiveku stops it.Added for you
Hiveku adds an address to your account’s suppression list when:- an email to it hard-bounces: the mailbox or the domain does not exist;
- its owner files a spam complaint by marking your email as spam.
suppressed_recipients, and the email goes to the other recipients. When every recipient is suppressed, the REST API refuses the email with 400 all_recipients_suppressed and sends nothing. The Resend-compatible API records such an email as not sent and answers with its id.
A hard bounce or a spam complaint recorded since 12 September 2026 stays on the list: it cannot be removed.
Added by you
Add an address yourself when you know someone should not get email:- they unsubscribed through your own app or preference center;
- they asked your support team to stop;
- it is an internal test address that production must never mail.
email:suppressions permission: tick Manage Suppressions on the key form. See Suppression List for listing and removing.
Bounces
Bounces come in two kinds:- Hard bounce: a permanent failure, such as an unknown user or a domain that does not exist. The address is suppressed.
- Soft bounce: a passing failure, such as a full mailbox or a busy server. Delivery is retried, and the address is not suppressed.
Complaints
A complaint means a recipient marked your email as spam. Theemail.complained event tells you about each one, with its type, such as abuse.
Keep complaints very low. Hiveku pauses the whole account’s sending when, over 30 days and at least 100 emails, complaints reach 0.3% and number at least 3.
View your suppressions
To see it:- Dashboard: Settings > Email Service > Suppression list lists every address with why it is there and when it was added. See Suppression List.
- API:
GET /api/v1/email/suppressionslists your account’s suppressions, with any key. It takestype(bounce,complaint,manual),search,pageandlimit. - AI assistant: ask it to list them.
- CRM: a contact’s page shows whether that contact is suppressed.
Best practices
Always include an unsubscribe link in marketing email
Always include an unsubscribe link in marketing email
Add a visible unsubscribe link in the email body, and the This turns on the one-click unsubscribe that Gmail and Apple Mail show. Honor an unsubscribe at once: add the address to your suppression list.
List-Unsubscribe and List-Unsubscribe-Post headers:Use double opt-in for subscribers
Use double opt-in for subscribers
When someone subscribes, send a confirmation email with a link, and add them to your list only once they click it. Double opt-in keeps typos, bots and fake sign-ups off your list, which are the main source of spam-trap hits.
Watch bounce and complaint rates
Watch bounce and complaint rates
Each domain’s page in Settings > Email Service > Email domains shows its bounce rate and complaint rate. Set up
email.bounced and email.complained webhooks to react as they happen. A sudden rise almost always points to a list problem or a bad template.Warm up new domains slowly
Warm up new domains slowly
A brand-new domain has no reputation. Start with a few hundred emails a day and grow over 2 to 4 weeks. A dedicated IP warms up on a schedule of its own, but the domain’s warm-up is still up to you.
Set up DMARC with a strict policy
Set up DMARC with a strict policy
Start with
p=quarantine for a few weeks, read the reports sent to your rua address, then move to p=reject once all of your real mail passes. Gmail and Yahoo expect DMARC from bulk senders. See Email Domains for the record.Always send from your own verified domain
Always send from your own verified domain
Hiveku sends only from domains you have verified, so a free mailbox address such as
@gmail.com cannot be your sender. Use a verified subdomain you own, such as noreply@mail.acme.com.Further reading
- Email Domains: DKIM, SPF and DMARC setup
- Dedicated IPs: when to send from your own IP
- Webhooks: react to bounces and complaints as they happen