Skip to content

Documentation

Held and refused messages.

Every customer shares one sending reputation, so we look at what new accounts send before it goes out. Nearly all mail passes without anyone noticing.

What happens

Before a message is sent, it is scanned for the signs of phishing and scams: a sender name or domain imitating a bank or a big brand, wording that asks for a password or threatens to close an account, links whose text names one site while going to another, attachments that are programs, and recipient lists that look scraped. The scan does not judge your writing and never reads mail it was not asked to send.

The result depends on how well we know the account:

  • Clear phishing from a new account is refused: the API answers 422 content_blocked with a plain reason. Nothing is sent and nothing is charged.
  • Something doubtful from a new account is accepted but held: its status is held and it is not sent until a person at Mailtruss has looked at it. It is then released, or refused with email.failed (reason content_rejected) and the sends it reserved are given back.
  • An established account (30 days old and in good standing, or one we have vetted) is never refused for content. Anything that looks like a hijacked account is held for a look; milder signs are only noted.
  • An account under review has a lower daily limit, and anything with a warning sign is held.

New accounts also start lower

For the first two weeks the daily limit grows each day (200, 500, 1,500, then 5,000 until the plan's full limit). A first paid plan restarts that climb for an account that is still new. If you have a launch coming, tell us and we will raise it. Broadcasts from a new account go to at most 500 people each and ask you to confirm that everyone on the list agreed to receive them.

If a real message was caught

Reply to the email we sent you about it, or write to support with the message id. A person looks at it, usually within a few hours on a working day, and the account is cleared so it does not happen again. Test messages to the mailtruss.test addresses are never scanned.

How to avoid it

  • Send from your own domain, in your own name. Do not use another company's name in the From name.
  • Link to your own site, and make link text match where it goes.
  • Do not attach programs or web pages; link to a download instead.
  • Mail only people who signed up. Role addresses such as info@ and misspelled domains are the mark of a scraped list.

Related: spam complaints, rate limits and quotas and the acceptable use policy.

Last updated

Something wrong or unclear on this page?

Report an issue