Email Deliverability — SPF, DKIM, DMARC & Reputation

import Ark from 'ark';

const client = new Ark();

async function sendToValidRecipients(recipients: string[], content: EmailContent) {
  const valid: string[] = [];

  for (const recipient of recipients) {
    try {
      await client.suppressions.retrieve(recipient);
      // Email is suppressed, skip it
    } catch (error) {
      if (error instanceof Ark.NotFoundError) {
        // Not suppressed, safe to send
        valid.push(recipient);
      } else {
        throw error;
      }
    }
  }

  if (valid.length > 0) {
    return client.emails.sendBatch({
      emails: valid.map(to => ({ ...content, to: [to] })),
    });
  }
}

require "ark_email"

client = ArkEmail::Client.new

def send_to_valid_recipients(recipients, content)
  valid = []

  recipients.each do |recipient|
    begin
      client.suppressions.retrieve(recipient)
      # Email is suppressed, skip it
    rescue ArkEmail::Errors::NotFoundError
      # Not suppressed, safe to send
      valid << recipient
    end
  end

  if valid.any?
    client.emails.send_batch(
      emails: valid.map { |r| content.merge(to: [r]) }
    )
  end
end

await client.emails.send({
  from: '"Your Company" <hello@yourdomain.com>',  // Friendly name
  to: ['user@example.com'],
  replyTo: 'support@yourdomain.com',  // Valid reply address
  subject: 'Hello',
  html: '<p>Hello!</p>',
});

client.emails.send_(
  from: '"Your Company" <hello@yourdomain.com>',  # Friendly name
  to: ["user@example.com"],
  reply_to: "support@yourdomain.com",  # Valid reply address
  subject: "Hello",
  html: "<p>Hello!</p>"
)

client.Emails.Send(ctx, ark.EmailSendParams{
    From:    `"Your Company" <hello@yourdomain.com>`, // Friendly name
    To:      []string{"user@example.com"},
    ReplyTo: ark.String("support@yourdomain.com"), // Valid reply address
    Subject: "Hello",
    HTML:    ark.String("<p>Hello!</p>"),
})

await client.emails.send({
  from: 'newsletter@yourdomain.com',
  to: ['subscriber@example.com'],
  subject: 'Weekly Newsletter',
  html: content,
  headers: {
    'List-Unsubscribe': '<mailto:unsubscribe@yourdomain.com>, <https://yourdomain.com/unsubscribe>',
    'List-Unsubscribe-Post': 'List-Unsubscribe=One-Click',
  },
});

client.emails.send_(
  from: "newsletter@yourdomain.com",
  to: ["subscriber@example.com"],
  subject: "Weekly Newsletter",
  html: content,
  headers: {
    "List-Unsubscribe" => "<mailto:unsubscribe@yourdomain.com>, <https://yourdomain.com/unsubscribe>",
    "List-Unsubscribe-Post" => "List-Unsubscribe=One-Click"
  }
)

client.Emails.Send(ctx, ark.EmailSendParams{
    From:    "newsletter@yourdomain.com",
    To:      []string{"subscriber@example.com"},
    Subject: "Weekly Newsletter",
    HTML:    ark.String(content),
    Headers: map[string]string{
        "List-Unsubscribe":      "<mailto:unsubscribe@yourdomain.com>, <https://yourdomain.com/unsubscribe>",
        "List-Unsubscribe-Post": "List-Unsubscribe=One-Click",
    },
})

app.post('/webhooks/ark', (req, res) => {
  const event = req.body;

  if (event.event === 'MessageBounced') {
    alertOps(`Bounce detected: ${JSON.stringify(event.payload)}`);
  }

  if (event.event === 'MessageComplained') {
    alertOps(`Spam complaint from: ${event.payload.message.to}`);
  }

  res.status(200).send('OK');
});

post '/webhooks/ark' do
  event = JSON.parse(request.body.read)

  if event['event'] == 'MessageBounced'
    alert_ops("Bounce detected: #{event['payload']}")
  end

  if event['event'] == 'MessageComplained'
    alert_ops("Spam complaint from: #{event['payload']['message']['to']}")
  end

  'OK'
end