Python Examples

pip install metigan
# or
pip3 install metigan

from metigan import MetiganClient

# Initialize the client
client = MetiganClient(api_key="your-api-key")

# Send email
result = client.email.send_email(
    from_address="Sender <sender@example.com>",
    recipients=["customer@email.com"],
    subject="Welcome!",
    content="<h1>Hello!</h1><p>Thank you for signing up.</p>"
)

if result["success"]:
    print("Email sent successfully!")
    print(f"Emails remaining: {result.get('emailsRemaining', 'N/A')}")

result = client.email.send_email(
    from_address="sender@example.com",
    recipients=["recipient@example.com"],
    subject="Email Subject",
    content="<h1>HTML Content</h1><p>This is the email body.</p>"
)

result = client.email.send_email(
    from_address="company@email.com",
    recipients=["main@email.com"],
    subject="Meeting",
    content="Email content",
    cc=["copy@email.com"],
    bcc=["hidden-copy@email.com"],
    reply_to="reply-here@email.com"
)

with open("document.pdf", "rb") as f:
    file_data = f.read()

result = client.email.send_email(
    from_address="company@email.com",
    recipients=["customer@email.com"],
    subject="Important Document",
    content="Please find the document attached.",
    attachments=[
        {
            "content": file_data,
            "filename": "document.pdf",
            "content_type": "application/pdf"
        }
    ]
)

result = client.email.send_email_with_template(
    template_id="template-123",
    variables={
        "name": "John Doe",
        "company": "Acme Inc"
    },
    from_address="sender@example.com",
    recipients=["recipient@example.com"]
)

contact = client.contacts.create(
    email="new@email.com",
    first_name="Jane",
    last_name="Doe",
    audience_id="audience-123",
    tags=["customer", "newsletter"]
)

# By ID
contact = client.contacts.get("contact-456")

# By email
contact = client.contacts.get_by_email("jane@email.com", "audience-123")

result = client.contacts.list(
    audience_id="audience-123",
    status="subscribed",
    page=1,
    limit=50
)

print(f"Total contacts: {result['pagination']['total']}")
for contact in result["contacts"]:
    print(f"{contact['email']}: {contact.get('first_name', 'N/A')}")

updated = client.contacts.update(
    contact_id="contact-456",
    first_name="Jane Marie",
    tags=["customer", "vip"]
)

# Subscribe
client.contacts.subscribe("contact-456")

# Unsubscribe
client.contacts.unsubscribe("contact-456")

# Add tags
client.contacts.add_tags("contact-456", ["vip", "black-friday"])

# Remove tags
client.contacts.remove_tags("contact-456", ["test"])

audience = client.audiences.create(
    name="Main Newsletter",
    description="Main subscriber list"
)

result = client.audiences.list(page=1, limit=10)

for audience in result["audiences"]:
    print(f"{audience['name']}: {audience['count']} contacts")

stats = client.audiences.get_stats("audience-123")

print(f"Total: {stats['total']}")
print(f"Subscribed: {stats['subscribed']}")
print(f"Unsubscribed: {stats['unsubscribed']}")

result = client.forms.submit(
    form_id="form-123",
    data={
        "field-email": "user@email.com",
        "field-name": "John Doe",
        "field-message": "Hello, I would like more information."
    }
)

print(result["message"])

form = client.forms.get("form-123")
print(form["title"])
print(form["fields"])

from metigan import MetiganClient, ApiError, ValidationError

try:
    result = client.email.send_email(options)
except ValidationError as e:
    print(f"Validation Error: {e.message}")
    if e.field:
        print(f"Field: {e.field}")
except ApiError as e:
    print(f"API Error: {e.status_code} - {e.message}")
except Exception as e:
    print(f"Unknown error: {e}")

from metigan import MetiganClient

client = MetiganClient(
    api_key="your-api-key",
    timeout=30,        # Optional, defaults to 30 seconds
    retry_count=3,     # Optional, defaults to 3
    retry_delay=2,     # Optional, defaults to 2 seconds
    debug=False        # Optional, defaults to False
)

from flask import Flask, request, jsonify
from metigan import MetiganClient
import os

app = Flask(__name__)
client = MetiganClient(api_key=os.getenv("METIGAN_API_KEY"))

@app.route("/send-email", methods=["POST"])
def send_email():
    data = request.get_json()
    
    try:
        result = client.email.send_email(
            from_address="noreply@example.com",
            recipients=[data["to"]],
            subject=data["subject"],
            content=data["content"]
        )
        
        return jsonify({
            "success": result.get("success"),
            "message": result.get("message")
        })
    except Exception as e:
        return jsonify({"error": str(e)}), 500

if __name__ == "__main__":
    app.run(debug=True)

from django.http import JsonResponse
from django.views.decorators.csrf import csrf_exempt
from django.views.decorators.http import require_http_methods
from metigan import MetiganClient
import os
import json

client = MetiganClient(api_key=os.getenv("METIGAN_API_KEY"))

@csrf_exempt
@require_http_methods(["POST"])
def send_email(request):
    try:
        data = json.loads(request.body)
        
        result = client.email.send_email(
            from_address="noreply@example.com",
            recipients=[data["to"]],
            subject=data["subject"],
            content=data["content"]
        )
        
        return JsonResponse({
            "success": result.get("success"),
            "message": result.get("message")
        })
    except Exception as e:
        return JsonResponse({"error": str(e)}, status=500)