Providers

from mailbridge import MailBridge

mailer = MailBridge(
    provider='sendgrid',
    api_key='SG.xxxxx',                     # Required — starts with 'SG.'
    from_email='noreply@yourdomain.com'      # Optional default sender
)

mailer.send(
    to='user@example.com',
    subject='', body='',
    template_id='d-1234567890abcdef',   # starts with 'd-'
    template_data={
        'user_name':       'Alice Smith',
        'activation_link': 'https://yourapp.com/activate/abc123'
    }
)

mailer.send(
    to='user@example.com',
    subject='Summer Campaign',
    body='
Special offer!
',
    headers={'X-Campaign-ID': 'summer-2025'},
    tags=['marketing', 'summer-campaign']   # For analytics in SendGrid dashboard
)

# Create template via AWS CLI
aws ses create-template --cli-input-json '{
  "Template": {
    "TemplateName": "WelcomeTemplate",
    "SubjectPart": "Welcome {{firstName}}!",
    "HtmlPart": "<h1>Hello {{firstName}}!</h1>",
    "TextPart": "Hello {{firstName}}!"
  }
}'

mailer.send(
    to='user@example.com',
    subject='', body='',
    template_id='WelcomeTemplate',      # The name you gave the template
    template_data={
        'firstName':     'Alice',
        'activationUrl': 'https://yourapp.com/activate/abc123'
    }
)

response = mailer.send(
    to='user@example.com',
    subject='Tracked Email',
    body='
Click here
',
    track_opens=True,
    track_links='HtmlAndText'   # 'None' | 'HtmlAndText' | 'HtmlOnly' | 'TextOnly'
)

mailer = MailBridge(
    provider='mailgun',
    api_key='key-xxxxx',
    domain='mg.yourdomain.com',          # Required — your Mailgun sending domain
    from_email='noreply@yourdomain.com'
)

# Template (use template name created in Mailgun dashboard)
mailer.send(
    to='user@example.com',
    subject='', body='',
    template_id='welcome-template',
    template_data={'name': 'Alice', 'activation_link': 'https://...'}
)

# With tracking tags
mailer.send(
    to='user@example.com',
    subject='Campaign',
    body='
Special offer!
',
    tags=['marketing', 'campaign-2025']
)

mailer = MailBridge(
    provider='brevo',
    api_key='xkeysib-xxxxx',             # Brevo API key — starts with 'xkeysib-'
    from_email='noreply@yourdomain.com'
)

# Template ID is an integer in Brevo
mailer.send(
    to='user@example.com',
    subject='', body='',
    template_id=12,                 # integer — not a string
    template_data={'name': 'Alice', 'company': 'Acme'}
)