Mailgun API Client

Mailgun homepage

Usage

1.) Creating object ( configuration )

There are three ways of creating Api object

from mgapi.mgapi import Api as MailgunApi
# With json config file (see config_example.json)
api = MailgunApi(
    config_file="C:\\Users\\Account\\Desktop\\config.json",
    debug=False
)
# Through parameters
api = MailgunApi(
    base_url="https://api.mailgun.net/v3",
    domain="<your_domain>",
    api_user="api",
    private_key="<your_private_key>"
)
# With configuration inherited from 'MGApiConfiguration' class in mgapi.py
# See 'MGApiConfiguration' class constructor
api = MailgunApi()

2.) Making request ( example )

from mgapi.mgapi import Api as MailgunApi
api = MailgunApi(config_file="C:\\Users\\Account\\Desktop\\config.json")
### Get stats for all event types
for event in api._EVENTS:
    print("-"*15, event.upper(), "-"*15)
    deserialized, serialized = api.get_stats_total(event=event)
    print(serialized)
### Send email 8 hours from now
# Set additional sending options
sending_options = api.ret_additional_sending_options()
sending_options["o:tag"] = ["MyTag"]
sending_options["o:deliverytime"] = api.nowRFC2822(hours=8)
# Send email
deserialized, serialized = api.send_single_message(
    From="YourNameHere <email@domain.io>",
    to="receiver@example.io",
    subject="Your Subject Here",
    html="<b>Test mail</b>",
    text="Test mail",
    additional_sending_options=sending_options
)
# print response
print(serialized)

Deserialized & Serialized

All methods that serve API endpoints return two values:

deserialized - deserialized JSON response (json object)

serialized - serialized JSON response (json string)

Justification

All request results come with additional key: justify

"justify": {
    "msg": "Operation succeeded.", # Message for user
    "reason": "",                  # justification of failure
    "success": true                # indicator of success or failure
}

Examples

For more examples check out examples directory.

Supported endpoints

For more information visit: Mailgun API Reference