Skip to main content

Suppressions

Suppressions prevent emails from being sent to specific addresses, protecting your sender reputation.

What Are Suppressions?

Suppressed addresses are email addresses that should not receive emails. This includes:
  • Hard bounces - Invalid addresses
  • Spam complaints - Recipients who marked you as spam
  • Unsubscribes - Recipients who opted out
  • Manual additions - Addresses you’ve blocked

Why Suppressions Matter

Sending to invalid addresses hurts deliverability.
Don’t waste sends on addresses that won’t receive them.

Automatic Suppressions

Lettr automatically suppresses addresses when:
EventSuppression TypeDuration
Hard bouncePermanentForever
Spam complaintPermanentForever
UnsubscribePermanentUntil removed
Soft bounce (3x)Temporary72 hours

View Suppressions

const suppressions = await lettr.suppressions.list({
  type: 'hard_bounce',
  limit: 100
});

suppressions.forEach(s => {
  console.log({
    email: s.email,
    type: s.type,
    reason: s.reason,
    suppressedAt: s.createdAt
  });
});

Check If Suppressed

const check = await lettr.suppressions.check('user@example.com');

if (check.suppressed) {
  console.log(`Suppressed: ${check.type} - ${check.reason}`);
} else {
  console.log('Email is not suppressed');
}

What Happens When You Send to Suppressed Addresses?

The email is silently dropped and counted as suppressed:
const result = await lettr.emails.send({
  from: 'you@example.com',
  to: ['suppressed@example.com'],
  subject: 'Hello',
  html: '<p>Hello!</p>'
});

// Returns:
{
  "id": "email_123",
  "status": "suppressed",
  "suppressionReason": "hard_bounce"
}

Learn More