Objective-C SDK for Mailgun
Switch branches/tags
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.


The Mailgun SDK allows your Mac OS X or iOS application to connect with the Mailgun programmable email platform. Send and manage mailing list subscriptions from your desktop or mobile applications and connect with your users directly in your application.

Requirements The AFNetworking library is required for the Mailgun client library.

Easy Image Attaching

Using MGMessage will allow you to attach UIImage or NSImage instances to a message. It will handle converting the image for you and attaching it either inline or to the message header.

API Support

At this time the full Mailgun REST API is not supported. Currently support is only provided to send messages, subscribe/unsubscribe from mailing lists and to check mailing lists subscriptions.

Note These features may be implemented at a later date.

Sending Example

 Mailgun *mailgun = [Mailgun clientWithDomain:@"samples.mailgun.org" apiKey:@"key-3ax6xnjp29jd6fds4gc373sgvjxteol0"];
 [mailgun sendMessageTo:@"Jay Baird <jay.baird@rackspace.com>" 
                   from:@"Excited User <someone@sample.org>" 
                subject:@"Mailgun is awesome!" 
                   body:@"A unicode snowman for you! ☃"];


  1. Install via Cocoapods

     pod install mailgun

    or add

     pod 'mailgun', '~> 1.0.3'

    to your Podfile.

  2. Install via Source

    1. Clone the repository.
    2. Copy Mailgun.h/.m and MGMessage.h/.m to your project.
    3. NOTE You will need to install the AFNetworking library to use the Mailgun SDK!