Nomsa Guide
  • 👋About Nomsa
  • Campaign Guide - General
    • 🚀How to send a campaign?
  • Campaign Guide - Email
    • 📧Email Campaigns - Basics
      • Scheduled Sending
      • Bounced Emails and Halted Campaigns
      • Email Statistics
      • Formatting your Message Template
      • Variable Fields
      • Unique URL Link per Recipient
      • Pasting Content from Microsoft Word
      • Manage your Unsubscriptions
      • Understanding Unsubscriptions
    • 🔐Sending Password-Protected Emails
      • Tutorial
  • Campaign Guide - SMS
    • 📲SMS Campaigns - Basics
    • SMS Onboarding Overview
      • How do I send SMS
  • Campaign Guide - Telegram
    • 🤖Telegram Campaigns - Basics
      • Add Telegram Bot Token in Nomsa
      • Instructions for Recipient Onboarding
      • Use the Bot in the Campaign
      • Telegram Formatting
      • Telegram Bot Statistics
  • Api Guide
    • 📖Overview
      • API Response Formats
      • Bearer Authentication
      • Generate your API Key
      • Rotate your API Key
    • 📨Programmatic Email API
      • Custom From Address
      • Tracking Email Status
      • Send Email API
        • From Name and From Address
        • CC and BCC
        • Recipient Blacklist
        • Email Tagging and Classification
        • Email Body
          • Embedding Images
            • Linked Images
            • Content-ID Images
        • Attachments
        • Rate Limit
      • Get Email by ID API
      • List Emails API
    • 📬Programmatic SMS API
Powered by GitBook
On this page
  • Purpose
  • Is my recipient on the blacklist?
  • How do I remove a recipient from the blacklist?
  1. Api Guide
  2. Programmatic Email API
  3. Send Email API

Recipient Blacklist

PreviousCC and BCCNextEmail Tagging and Classification

Last updated 1 year ago

Purpose

We keep a blacklist of email addresses to whom our system will not send emails. Typically, these email addresses are added to the blacklist after a delivery attempt has resulted in a hard bounce, (e.g. the email address does not exist).

Without a blacklist, our system would continue to attempt to send emails to these addresses, which would result in a poor reputation for our system and adversely impact the deliverability of emails to other recipients.

Is my recipient on the blacklist?

Currently, we do not provide a way to check if a recipient is on the blacklist prior to sending out an email.

However, there are two ways you will be informed if a recipient is on the blacklist:

  1. In our current setup, during your API call to our system, we will check if the recipient is on the blacklist. If the recipient is on the blacklist, we will return an error message indicating that the recipient is on the blacklist. However, to scale our system, we plan to change this behavior in the future, so we advise against relying on this behavior.

  2. You can query an email by its ID using this . If the email was not sent because the recipient was on the blacklist, this will be indicated in the errorCode field of the response.

How do I remove a recipient from the blacklist?

There are some instances where a blacklisted recipient may be a valid recipient. For example, if a recipient's email address was blacklisted because it did not exist, but the recipient has since created an email address with the same email address, then the recipient should be removed from the blacklist.

In this case, you should to remove the recipient from the blacklist.

📨
API endpoint
contact us