Ruby SDK email client

client = Paubox::Client.new                          # uses global Paubox.configure credentials
client = Paubox::Client.new(api_key: 'YOUR_API_KEY') # or a per-client API key

message = Paubox::Message.new(
  from:                    'sender@yourdomain.com',  # required
  to:                      ['alice@example.com'],    # required; array
  subject:                 'Your results are ready', # optional
  reply_to:                'support@yourdomain.com', # optional
  cc:                      ['manager@example.com'],  # optional
  bcc:                     ['audit@example.com'],    # optional
  text_content:            'Plain text body.',       # at least one required
  html_content:            '<p>HTML body.</p>',      # optional
  allow_non_tls:           false,                    # optional; default false
  force_secure_notification: false                   # optional; default false
)

message.add_attachment('/path/to/report.pdf')

require 'base64'

message.attachments = [
  {
    fileName:    'report.pdf',
    contentType: 'application/pdf',
    content:     Base64.strict_encode64(File.read('/path/to/report.pdf'))
  }
]

response = client.send_mail(message)
puts response[:source_tracking_id]

disposition = client.email_disposition(source_tracking_id)

disposition.message_deliveries.each do |delivery|
  puts "#{delivery.recipient} → #{delivery.status.delivery_status}"
  puts "  Opened: #{delivery.status.opened_status}"
end

response = client.schedule_mail(message, '2025-12-25T15:00:00Z')
puts response['sourceTrackingId']
puts response['scheduledAt']

status = client.get_scheduled(source_tracking_id)
puts status['state']          # "pending", "sent", "cancelled"
puts status['scheduledAt']

response = client.reschedule(source_tracking_id, '2025-12-26T10:00:00Z')
puts response['scheduledAt']

response = client.cancel_scheduled(source_tracking_id)
puts response['state']        # "cancelled"

Paubox::DynamicTemplates.create('appointment-confirmation', '/path/to/template.html')

templates = Paubox::DynamicTemplates.list
templates.each { |t| puts "#{t[:id]}: #{t[:name]}" }

template = Paubox::DynamicTemplates.find(template_id)

template.update('/path/to/updated-template.html')
# or rename:
template.update('/path/to/updated-template.html', 'new-template-name')

template.delete

message = Paubox::TemplatedMessage.new(
  from:    'appointments@yourclinic.com',
  to:      ['jane@example.com'],
  subject: 'Your appointment is confirmed',
  template: {
    name:   'appointment-confirmation',
    values: {
      first_name: 'Jane',
      date:       '2024-03-15',
      time:       '2:00 PM'
    }
  }
)

response = client.send_mail(message)

require 'rest-client'

begin
  response = client.send_mail(message)
rescue RestClient::ExceptionWithResponse => e
  puts "HTTP #{e.response.code}: #{e.response.body}"
end