Bounce Handling — Hard Bounces, Soft Bounces & Suppressions

import Ark from 'ark-email';

const client = new Ark();

// Check if suppressed
try {
  const suppression = await client.suppressions.retrieve('user@example.com');
  console.log(`Suppressed: ${suppression.data.reason}`);
} catch (error) {
  if (error instanceof Ark.NotFoundError) {
    console.log('Not suppressed');
  }
}

// Remove from suppression
await client.suppressions.delete('user@example.com');

# Check if suppressed
curl "https://api.arkhq.io/v1/suppressions/user%40example.com" \
  -H "Authorization: Bearer $ARK_API_KEY"

# Remove from suppression
curl -X DELETE "https://api.arkhq.io/v1/suppressions/user%40example.com" \
  -H "Authorization: Bearer $ARK_API_KEY"

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

  if (payload.status === 'HardFail') {
    // Automatically suppressed by Ark
    await markEmailInvalid(payload.message.to, 'hard_bounce');
  }

  if (payload.status === 'SoftFail') {
    // Ark will retry — log for diagnostics
    console.log(`Soft bounce: ${payload.classification}`);
  }

  // NDR bounce
  if (payload.original_message) {
    const recipient = payload.original_message.to;
    await markEmailInvalid(recipient, 'bounced');
    // Optionally suppress via API
    await client.suppressions.create({ email: recipient });
  }

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

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

  case payload['status']
  when 'HardFail'
    # Automatically suppressed by Ark
    mark_email_invalid(payload.dig('message', 'to'), 'hard_bounce')
  when 'SoftFail'
    # Ark will retry — log for diagnostics
    puts "Soft bounce: #{payload['classification']}"
  end

  # NDR bounce
  if payload['original_message']
    recipient = payload.dig('original_message', 'to')
    mark_email_invalid(recipient, 'bounced')
    client.suppressions.create(email: recipient)
  end

  'OK'
end

func handleWebhook(w http.ResponseWriter, r *http.Request) {
    var payload map[string]interface{}
    json.NewDecoder(r.Body).Decode(&payload)

    status, _ := payload["status"].(string)

    switch status {
    case "HardFail":
        // Automatically suppressed by Ark
        msg := payload["message"].(map[string]interface{})
        markEmailInvalid(msg["to"].(string), "hard_bounce")
    case "SoftFail":
        // Ark will retry — log for diagnostics
        log.Printf("Soft bounce: %s", payload["classification"])
    }

    // NDR bounce
    if origMsg, ok := payload["original_message"]; ok {
        orig := origMsg.(map[string]interface{})
        recipient := orig["to"].(string)
        markEmailInvalid(recipient, "bounced")
    }

    w.WriteHeader(http.StatusOK)
}