mailgun-ruby 1.2.13 → 1.2.14

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 63fbab3c08481c2364ca4fef89def410a12672507954764103e900bb0f081858
-  data.tar.gz: e2fed301bb806d720b6e7f9f8707d415756ed92f5b841592ebc100eb53a71d74
+  metadata.gz: 3905ad8ab1dae85ea3b87b10d2ac01700de085adab73d9e02373f4d54e70451d
+  data.tar.gz: e5794e301066318205a9ffb6de455d73642d3162b1ad75900cefed7aa95db798
 SHA512:
-  metadata.gz: 69ad70a850bdb1cbc859647509315b118aa7508747c8af281eeb7ec4514156f1416aa16b4d0e10e07fa168adc705ba110d20b28aae3137b26c454cdf9115b191
-  data.tar.gz: e5f30539ca1dfd25ab6bd489c7544febd7b54ae00b407c3378e9ecd3c7166efd961d76f73943e931015436880eab72b607cea5629bf26fda811cbfec1dc1e787
+  metadata.gz: af8ed54564c2f13b818aa7da6a550b9000b4148ee437b108d01219d80b610580fde3a1973dd831db3ffd8b0dbe934d9288b479a335a5521e3f275815a9f30c8e
+  data.tar.gz: 5d11d20420e6333e9e71104fc529d80f19ed689cb300bc5b19ec4c2b855e9c92e24e59d7de83122d2bcdc910a0ec60f783ea277e011e8d375bb1e471be30802e

data/CHANGELOG.md

@@ -4,13 +4,33 @@ All notable changes to this project will be documented in this file.
 
 ## [Unreleased]
 
+## [1.2.14] - 2024-02-13
+
+### Added
+
+- Tags CRUD support (https://github.com/mailgun/mailgun-ruby/pull/316)
+- Additional Domain Endpoints (https://github.com/mailgun/mailgun-ruby/pull/314)
+- Webhooks Update Method (https://github.com/mailgun/mailgun-ruby/pull/305)
+- Add support for AMP HTML (https://github.com/mailgun/mailgun-ruby/pull/304)
+- Add support for AMP HTML (https://github.com/mailgun/mailgun-ruby/pull/304)
+
+### Fixed
+
+- Typos in docs, specs (- Add support for AMP HTML (https://github.com/mailgun/mailgun-ruby/pull/304)).
+
 ## [1.2.13] - 2023-11-25
 
 ### Added
 
-- Subaccounts API support (https://github.com/mailgun/mailgun-ruby/pull/300).
+- Subaccounts API support (https://github.com/mailgun/mailgun-ruby/pull/310).
+
+## [1.2.12] - 2023-10-22
+
+### Added
+
+- Templates CRUD support (https://github.com/mailgun/mailgun-ruby/pull/300).
 
 ### Fixed
 
 - transform_for_mailgun block iteration issue (https://github.com/mailgun/mailgun-ruby/pull/298).
-- Typos in several files (https://github.com/mailgun/mailgun-ruby/pull/297).
+- Typos in several files (https://github.com/mailgun/mailgun-ruby/pull/297).

data/README.md

@@ -19,7 +19,7 @@ gem install mailgun-ruby
 Gemfile:
 
 ```ruby
-gem 'mailgun-ruby', '~>1.2.12'
+gem 'mailgun-ruby', '~>1.2.14'
 ```
 
 Usage

data/docs/Domains.md

@@ -53,5 +53,5 @@ See the [Suppressions](/docs/Suppressions.md) for usage samples and
 
 More Documentation
 ------------------
-See the official [Mailgun Domain Docs](https://documentation.mailgun.com/api-domains.html)
+See the official [Mailgun Domain Docs](https://documentation.mailgun.com/en/latest/api-domains.html)
 for more information

data/docs/Events.md

@@ -42,5 +42,5 @@ last time you called "next".
 
 More Documentation
 ------------------
-See the official [Mailgun Docs](http://documentation.mailgun.com/api-sending.html)
+See the official [Mailgun Docs](https://documentation.mailgun.com/en/latest/api-events.html)
 for more information.

data/docs/MessageBuilder.md

@@ -104,5 +104,5 @@ message_ids = mb_obj.finalize
 
 More Documentation
 ------------------
-See the official [Mailgun Docs](http://documentation.mailgun.com/api-sending.html)
+See the official [Mailgun Docs](https://documentation.mailgun.com/en/latest/api-sending.html)
 for more information.

data/docs/Messages.md

@@ -103,5 +103,5 @@ message_ids = mb_obj.finalize
 
 More Documentation
 ------------------
-See the official [Mailgun Docs](https://documentation.mailgun.com/api-sending.html)
+See the official [Mailgun Docs](https://documentation.mailgun.com/en/latest/api-sending.html)
 for more information.

data/docs/OptInHandler.md

@@ -100,4 +100,4 @@ Available Functions
 
 More Documentation
 ------------------
-See the official [Mailgun Docs](https://documentation.mailgun.com/en/latest/api-sending.html) for more information.
+See the official [Mailgun Docs](https://documentation.mailgun.com/) for more information.

data/docs/Snippets.md

@@ -513,7 +513,7 @@ Be sure to visit the Mailgun official
 information about our API.
 
 If you find a bug, please submit the issue in Github directly.
-[Mailgun-Ruby Issues](https://github.com/mailgun/Mailgun-PHP/issues)
+[Mailgun-Ruby Issues](https://github.com/mailgun/mailgun-ruby/issues)
 
 As always, if you need additional assistance, drop us a note at
 [support@mailgun.com](mailto:support@mailgun.com).

data/docs/Webhooks.md

@@ -36,5 +36,5 @@ hook.remove_all 'my.perfect.domain'
 
 More Documentation
 ------------------
-See the official [Mailgun Domain Docs](https://documentation.mailgun.com/api-webhooks.html)
+See the official [Mailgun Domain Docs](https://documentation.mailgun.com/en/latest/api-webhooks.html)
 for more information

data/lib/mailgun/client.rb

@@ -30,6 +30,7 @@ module Mailgun
       RestClient.proxy = proxy_url
       @http_client = RestClient::Resource.new(endpoint, rest_client_params)
       @test_mode = test_mode
+      @api_version = api_version
     end
 
     # Enable test mode
@@ -68,6 +69,11 @@ module Mailgun
       @test_mode
     end
 
+    # @return [String] client api version
+    def api_version
+      @api_version
+    end
+
     # Provides a store of all the emails sent in test mode so you can check them.
     #
     # @return [Hash]
@@ -168,8 +174,12 @@ module Mailgun
     # @param [String] resource_path This is the API resource you wish to interact
     # with. Be sure to include your domain, where necessary.
     # @return [Mailgun::Response] A Mailgun::Response object.
-    def delete(resource_path)
-      response = @http_client[resource_path].delete
+    def delete(resource_path, params = nil)
+      if params
+        response = @http_client[resource_path].delete(params: params)
+      else
+        response = @http_client[resource_path].delete
+      end
       Response.new(response)
     rescue => err
       raise communication_error err

data/lib/mailgun/domains/domains.rb

@@ -95,8 +95,236 @@ module Mailgun
     #
     # Returns [Hash] of updated domain
     def update(domain, options = {})
-      fail(ParameterError, 'No domain given to add on Mailgun', caller) unless domain
+      fail(ParameterError, 'No domain given to update on Mailgun', caller) unless domain
       @client.put("domains/#{domain}", options).to_h
     end
+
+    # Public: Creates a new set of SMTP credentials for the defined domain.
+    #
+    # domain  - [String] Name of the domain (ex. domain.com)
+    # options - [Hash] of
+    #   login  - [String] The user name (ex. bob.bar)
+    #   password  - [String] A password for the SMTP credentials. (Length Min 5, Max 32)
+    #
+    # Returns [Hash] with message key
+    def create_smtp_credentials(domain, options = {})
+      fail(ParameterError, 'No domain given to create credentials on Mailgun', caller) unless domain
+      @client.post("domains/#{domain}/credentials", options).to_h
+    end
+
+    # Public: Updates the specified SMTP credentials.
+    #
+    # domain  - [String] Name of the domain (ex. domain.com)
+    # login  - [String] The user name (ex. bob.bar)
+    # options - [Hash] of
+    #   password  - [String] A password for the SMTP credentials. (Length Min 5, Max 32)
+    #
+    # Returns [Hash] with message key
+    def update_smtp_credentials(domain, login, options = {})
+      fail(ParameterError, 'No domain given to update credentials on Mailgun', caller) unless domain
+      fail(ParameterError, 'No login given to update credentials on Mailgun', caller) unless login
+      @client.put("domains/#{domain}/credentials/#{login}", options).to_h
+    end
+
+    # Public: Deletes the defined SMTP credentials.
+    #
+    # domain  - [String] Name of the domain (ex. domain.com)
+    # login  - [String] The user name (ex. bob.bar)
+    #
+    # Returns [Hash] with message and spec keys
+    def delete_smtp_credentials(domain, login)
+      fail(ParameterError, 'No domain given to delete credentials on Mailgun', caller) unless domain
+      fail(ParameterError, 'No login given to delete credentials on Mailgun', caller) unless login
+      @client.delete("domains/#{domain}/credentials/#{login}").to_h
+    end
+
+    # Public: Returns delivery connection settings for the defined domain.
+    #
+    # domain  - [String] Name of the domain (ex. domain.com)
+    #
+    # Returns [Hash] Information on the delivery connection settings
+    def get_domain_connection_settings(domain)
+      fail(ParameterError, 'No domain given to retrieve connections on Mailgun', caller) unless domain
+      @client.get("domains/#{domain}/connection").to_h
+    end
+
+    # Public: Updates the specified delivery connection settings for the defined domain.d
+    #
+    # domain  - [String] Name of the domain (ex. domain.com)
+    # options - [Hash] of
+    #   require_tls  - [Boolean] true or false. If true - requires the message only be sent over a TLS connection
+    #   skip_verification  - [Boolean] true or false. If true - the certificate and hostname will not be verified
+    #     when trying to establish a TLS connection
+    #
+    # Returns [Hash] Information on the delivery connection settings
+    def update_domain_connection_settings(domain, options = {})
+      fail(ParameterError, 'No domain given to update connections on Mailgun', caller) unless domain
+      @client.put("domains/#{domain}/connection", options).to_h
+    end
+
+    # Public: Returns tracking settings for the defined domain.
+    #
+    # domain  - [String] Name of the domain (ex. domain.com)
+    #
+    # Returns [Hash] Information on the tracking settings
+    def get_domain_tracking_settings(domain)
+      fail(ParameterError, 'No domain given to retrieve tracking settings on Mailgun', caller) unless domain
+      @client.get("domains/#{domain}/tracking").to_h
+    end
+
+    # Public: Updates the open tracking settings for a domain.
+    #
+    # domain  - [String] Name of the domain (ex. domain.com)
+    # options - [Hash] of
+    #   active  - [Boolean] yes or no. If set to yes, a tracking pixel will be inserted below your HTML content.
+    #   place_at_the_top  - [Boolean] yes or no. If set to yes, tracking pixel will be moved to top of your HTML content.
+    #
+    # Returns [Hash] Information on the tracking open settings
+    def update_domain_tracking_open_settings(domain, options = {})
+      fail(ParameterError, 'No domain given to update tracking settings on Mailgun', caller) unless domain
+      @client.put("domains/#{domain}/tracking/open", options).to_h
+    end
+
+    # Public: Updates the click tracking settings for a domain.
+    #
+    # domain  - [String] Name of the domain (ex. domain.com)
+    # options - [Hash] of
+    #   active  - [Boolean] yes or no. If set to yes, links will be overwritten and pointed to our servers so we can track clicks.
+    #
+    # Returns [Hash] Information on the tracking click settings
+    def update_domain_tracking_click_settings(domain, options = {})
+      fail(ParameterError, 'No domain given to update tracking settings on Mailgun', caller) unless domain
+      @client.put("domains/#{domain}/tracking/click", options).to_h
+    end
+
+    # Public: Updates unsubscribe tracking settings for a domain.
+    #
+    # domain  - [String] Name of the domain (ex. domain.com)
+    # options - [Hash] of
+    #   active  - [Boolean] true or false.
+    #   html_footer  - [String] Custom HTML version of unsubscribe footer.
+    #   text_footer  - [String] Custom text version of unsubscribe footer.
+    #
+    # Returns [Hash] Information on the tracking unsubscribe settings
+    def update_domain_tracking_unsubscribe_settings(domain, options = {})
+      fail(ParameterError, 'No domain given to update tracking settings on Mailgun', caller) unless domain
+      @client.put("domains/#{domain}/tracking/unsubscribe", options).to_h
+    end
+
+    # Public: Change the DKIM authority for a domain.
+    #
+    # domain  - [String] Name of the domain (ex. domain.com)
+    # options - [Hash] of
+    #   self  - [Boolean] true - the domain will be the DKIM authority for itself even
+    #           if the root domain is registered on the same mailgun account
+    #
+    # Returns [Hash] Information on the DKIM authority
+    def update_domain_dkim_authority(domain, options = {})
+      fail(ParameterError, 'No domain given to update tracking settings on Mailgun', caller) unless domain
+      @client.put("domains/#{domain}/dkim_authority", options).to_h
+    end
+
+    # Public: Update the DKIM selector for a domains
+    #
+    # domain  - [String] Name of the domain (ex. domain.com)
+    # options - [Hash] of
+    #   dkim_selector  - [String] change the DKIM selector for a domain.
+    #
+    # Returns [Hash] with message key
+    def update_domain_dkim_selector(domain, options = {})
+      fail(ParameterError, 'No domain given to update tracking settings on Mailgun', caller) unless domain
+      @client.put("domains/#{domain}/dkim_selector", options).to_h
+    end
+
+    # Public: Update the CNAME used for tracking opens and clicks
+    #
+    # domain  - [String] Name of the domain (ex. domain.com)
+    # options - [Hash] of
+    #   web_prefix  - [String] change the tracking CNAME for a domain.
+    #
+    # Returns [Hash] with message key
+    def update_domain_web_prefix(domain, options = {})
+      fail(ParameterError, 'No domain given to update tracking settings on Mailgun', caller) unless domain
+      @client.put("domains/#{domain}/web_prefix", options).to_h
+    end
+
+    # Public: Lists the domain keys for a specified signing domain / authority
+    #
+    # domain  - [String] Name of the domain (ex. domain.com)
+    #
+    # Returns [Hash] with domain keys data
+    def get_domain_keys(domain)
+      fail(ParameterError, 'Client api version must be v4', caller) unless @client.api_version == 'v4'
+      fail(ParameterError, 'No domain given to retrieve keys on Mailgun', caller) unless domain
+      @client.get("domains/#{domain}/keys").to_h
+    end
+
+    # Public: Activate a domain key for a specified authority and selector.
+    #
+    # domain    - [String] Name of the domain (ex. domain.com)
+    # selector  - [String] The selector you want to activate for the domain key
+    #
+    # Returns [Hash] with message key and autority + selector data
+    def activate_domain_key(domain, selector)
+      fail(ParameterError, 'Client api version must be v4', caller) unless @client.api_version == 'v4'
+      fail(ParameterError, 'No domain given to update tracking settings on Mailgun', caller) unless domain
+      fail(ParameterError, 'No selector given to activate key on Mailgun', caller) unless selector
+      @client.put("domains/#{domain}/keys/#{selector}/activate", {}).to_h
+    end
+
+    # Public: Deactivate a domain key for a specified authority and selector
+    #
+    # domain    - [String] Name of the domain (ex. domain.com)
+    # selector  - [String] The selector you want to activate for the domain key
+    #
+    # Returns [Hash] with message key and autority + selector data
+    def deactivate_domain_key(domain, selector)
+      fail(ParameterError, 'Client api version must be v4', caller) unless @client.api_version == 'v4'
+      fail(ParameterError, 'No domain given to update tracking settings on Mailgun', caller) unless domain
+      fail(ParameterError, 'No selector given to activate key on Mailgun', caller) unless selector
+      @client.put("domains/#{domain}/keys/#{selector}/deactivate", {}).to_h
+    end
+
+    # Public: Create a domain key
+    #
+    # options - [Hash] of
+    #   signing_domain  - [String] Name of the domain (ex. domain.com)
+    #   selector - [String] Selector to be used for the new domain key
+    #   bits - [Integer] Key size, can be 1024 or 2048
+    #   pem - [String] Private key PEM
+    #
+    # Returns [Hash] with message key
+    def create_domain_key(options = {})
+      fail(ParameterError, 'Client api version must be v1', caller) unless @client.api_version == 'v1'
+      @client.post("dkim/keys", options).to_h
+    end
+
+    # Public: Delete a domain key.
+    #
+    # options - [Hash] of
+    #   signing_domain - [Integer] Name of the domain (ex. domain.com)
+    #   selector - [String] Name of the selector
+    #
+    # Returns [Hash] with message key
+    def delete_domain_key(options = {})
+      fail(ParameterError, 'Client api version must be v1', caller) unless @client.api_version == 'v1'
+      @client.delete("dkim/keys", options).to_h
+    end
+
+    # Public: Returns total stats for a given domains
+    #
+    # domain    - [String] Name of the domain (ex. domain.com)
+    # options - [Hash] of
+    #   event - [String] The type of the event.
+    #   start - [String] The starting time. Should be in RFC 2822 or unix epoch format.
+    #   end - [String] The ending date. Should be in RFC 2822 or unix epoch format
+    #   resolution - [String] Can be either hour, day or month. Default: day
+    #   duration - [String] Period of time with resoluton encoded
+    #
+    # Returns [Array] A list of domains (hash)
+    def get_domain_stats(domain, options = {})
+      fail(ParameterError, 'No domain given to list stats on Mailgun', caller) unless domain
+      @client.get("#{domain}/stats/total", options).to_h
+    end
   end
 end

data/lib/mailgun/messages/message_builder.rb

@@ -116,6 +116,14 @@ module Mailgun
       body_html(html_body)
     end
 
+    # Set an AMP part for the message object
+    #
+    # @param [String] amp The AMP HTML for the email.
+    # @return [void]
+    def amp_html(amp = nil)
+      set_single('amp-html', amp)
+    end
+
     # Adds a series of attachments, when called upon.
     #
     # @param [String|File] attachment A file object for attaching as an attachment.

data/lib/mailgun/tags/tags.rb

@@ -0,0 +1,120 @@
+require 'mailgun/exceptions/exceptions'
+
+module Mailgun
+
+  # A Mailgun::Tags object is a simple CRUD interface to Mailgun Tags.
+  # Uses Mailgun
+  class Tags
+
+    # Public: creates a new Mailgun::Tags instance.
+    # Defaults to Mailgun::Client
+    def initialize(client = Mailgun::Client.new)
+      @client = client
+    end
+
+    # Public: Get Tags
+    #
+    # domain - [String] Domain name where tag is stored
+    # options - [Hash] of
+    #    limit  - [Integer] Number of entries to return. Default: 100.
+    #
+    # Returns [Array] A list of tags (hash)
+    def get_tags(domain, options = {})
+      fail(ParameterError, 'No domain given to store template on', caller) unless domain
+      @client.get("#{domain}/tags", options).to_h['items']
+    end
+
+    # Public: Get tag information
+    #
+    # domain - [String] Domain name where tag is stored
+    # tag    - [String] Tag name to lookup for
+    #
+    # Returns [Hash] Information on the requested tag.
+    def get_tag(domain, tag)
+      fail(ParameterError, 'No domain given to find on Mailgun', caller) unless domain
+      fail(ParameterError, 'No tag name given to find on provided domain', caller) unless tag
+      @client.get("#{domain}/tags/#{tag}").to_h!
+    end
+
+    # Public: Updates a given tag with the information provided
+    #
+    # domain - [String] Domain name where tag is stored
+    # tag    - [String] Tag name to lookup for
+    # options - [Hash] of
+    #     description - [String] Updated description of the tag
+    #
+    # Returns [Boolean] if successful or not
+    def update(domain, tag, options = {})
+      fail(ParameterError, 'No domain given to find on Mailgun', caller) unless domain
+      fail(ParameterError, 'No tag name given to find on provided domain', caller) unless tag
+      @client.put("#{domain}/tags/#{tag}", options).to_h['message'] == 'Tag updated'
+    end
+
+    # Public: Get statistics for a given tag
+    #
+    # domain - [String] Domain name where tag is stored
+    # tag    - [String] Tag name to lookup for
+    # options - [Hash] of
+    #     event - [String] The type of the event. Required. (ex. accepted, delivered, failed, opened)
+    #     start - [String] The starting time. Should be in RFC 282 or unix epoch format. Default: 7 days from the current time.
+    #     end   - [String] The ending date. Should be in RFC 2822 or unix epoch time in seconds. Default: current time.
+    #     resolution   - [String] Can be either hour, day or month. Default: day
+    #     duration   - [String] Period of time with resolution encoded. If provided, overwrites the start date and resolution.
+    #
+    # Returns [Hash] of tag stats info
+    def get_tag_stats(domain, tag, options = {})
+      fail(ParameterError, 'No domain given to find on Mailgun', caller) unless domain
+      fail(ParameterError, 'No tag name given to find on provided domain', caller) unless tag
+      @client.get("#{domain}/tags/#{tag}/stats", options).to_h
+    end
+
+    # Public: Delete Tag
+    # NOTE: Deletes the tag. Note: The statistics for the tag are not destroyed.
+    #
+    # domain - [String] Domain name where tag is stored
+    # tag    - [String] Tag name to lookup for
+    #
+    # Returns [Boolean] if successful or not
+    def remove(domain, tag)
+      fail(ParameterError, 'No domain given to remove on Mailgun', caller) unless domain
+      fail(ParameterError, 'No template name given to find on provided domain', caller) unless tag
+      @client.delete("#{domain}/tags/#{tag}").to_h['message'] == 'Tag deleted'
+    end
+
+    # Public: Get a list of countries of origin for a given domain for different event types.
+    #
+    # domain - [String] Domain name where tag is stored
+    # tag    - [String] Tag name to lookup for
+    #
+    # Returns [Hash] of countries of origin for a given domain
+    def get_countries_aggregated_stats(domain, tag)
+      fail(ParameterError, 'No domain given to find on Mailgun', caller) unless domain
+      fail(ParameterError, 'No tag name given to find on provided domain', caller) unless tag
+      @client.get("#{domain}/tags/#{tag}/stats/aggregates/countries").to_h
+    end
+
+    # Public: Get a list of email providers for a given domain for different event types
+    #
+    # domain - [String] Domain name where tag is stored
+    # tag    - [String] Tag name to lookup for
+    #
+    # Returns [Hash] of email providers for a given domain
+    def get_providers_aggregated_stats(domain, tag)
+      fail(ParameterError, 'No domain given to find on Mailgun', caller) unless domain
+      fail(ParameterError, 'No tag name given to find on provided domain', caller) unless tag
+      @client.get("#{domain}/tags/#{tag}/stats/aggregates/providers").to_h
+    end
+
+    # Public: Get a list of devices for a given domain that have triggered event types.
+    #
+    # domain - [String] Domain name where tag is stored
+    # tag    - [String] Tag name to lookup for
+    #
+    # Returns [Hash] of devices for a given domain
+    def get_devices_aggregated_stats(domain, tag)
+      fail(ParameterError, 'No domain given to find on Mailgun', caller) unless domain
+      fail(ParameterError, 'No tag name given to find on provided domain', caller) unless tag
+      @client.get("#{domain}/tags/#{tag}/stats/aggregates/devices").to_h
+    end
+  end
+end

data/lib/mailgun/version.rb

@@ -1,4 +1,4 @@
 # It's the version. Yeay!
 module Mailgun
-  VERSION = '1.2.13'
+  VERSION = '1.2.14'
 end

data/lib/mailgun/webhooks/webhooks.rb

@@ -3,6 +3,7 @@ module Mailgun
   # A Mailgun::Webhooks object is a simple CRUD interface to Mailgun Webhooks.
   # Uses Mailgun
   class Webhooks
+    ACTIONS = %w(accepted clicked complained delivered opened permanent_fail temporary_fail unsubscribed).freeze
 
     # Public creates a new Mailgun::Webhooks instance.
     #   Defaults to Mailgun::Client
@@ -31,7 +32,7 @@ module Mailgun
     #   empty String if one is not set
     def info(domain, action)
       res = @client.get("domains/#{domain}/webhooks/#{action}")
-      res.to_h['webhook']['url'] || ''
+      res.to_h['webhook']['urls'] || ''
     rescue NoMethodError
       ''
     end
@@ -46,7 +47,7 @@ module Mailgun
     # Returns a Boolean of whether the webhook was created
     def create(domain, action, url = '')
       res = @client.post("domains/#{domain}/webhooks", id: action, url: url)
-      res.to_h['webhook']['url'] == url && res.to_h['message'] == 'Webhook has been created'
+      res.to_h['webhook']['urls'].include?(url) && res.to_h['message'] == 'Webhook has been created'
     end
     alias_method :add, :create
     alias_method :add_webhook, :create
@@ -58,7 +59,7 @@ module Mailgun
     #
     # Returns true or false
     def create_all(domain, url = '')
-      %w(accepted clicked complained delivered opened permanent_fail temporary_fail unsubscribed).each do |action|
+      ACTIONS.each do |action|
         add_webhook domain, action, url
       end
       true
@@ -67,6 +68,21 @@ module Mailgun
     end
     alias_method :add_all_webhooks, :create_all
 
+    # Public: Update webhook
+    #
+    # domain - A String of the domain name (ex. domain.com)
+    # action - A String of the action to create a webhook for
+    # url    - A String of the url of the webhook
+    #
+    # Returns a Boolean of whether the webhook was updated
+    def update(domain, action, url = '')
+      fail Mailgun::ParameterError('Domain not provided to update webhooks') unless domain
+      fail Mailgun::ParameterError('Action not provided to identify webhook to update') unless action
+      res = @client.put("domains/#{domain}/webhooks/#{action}", id: action, url: url)
+      res.to_h['webhook']['urls'] == url && res.to_h['message'] == 'Webhook has been updated'
+    end
+    alias_method :update_webhook, :update
+
     # Public: Delete a specific webhook
     #
     # domain - The required String of domain name
@@ -90,7 +106,7 @@ module Mailgun
     # Returns a Boolean on the success
     def remove_all(domain)
       fail Mailgun::ParameterError('Domain not provided to remove webhooks from') unless domain
-      %w(accepted clicked complained delivered opened permanent_fail temporary_fail unsubscribed).each do |action|
+      ACTIONS.each do |action|
         delete_webhook domain, action
       end
     end

data/lib/mailgun.rb

@@ -17,6 +17,7 @@ require 'mailgun/domains/domains'
 require 'mailgun/webhooks/webhooks'
 require 'mailgun/templates/templates'
 require 'mailgun/subaccounts/subaccounts'
+require 'mailgun/tags/tags'
 
 # Module for interacting with the sweet Mailgun API.
 #

data/lib/railgun/mailer.rb

@@ -173,6 +173,7 @@ module Railgun
     mb.subject mail.subject
     mb.body_html extract_body_html(mail)
     mb.body_text extract_body_text(mail)
+    mb.amp_html extract_amp_html(mail)
 
     [:to, :cc, :bcc].each do |rcpt_type|
       addrs = mail[rcpt_type] || nil
@@ -232,6 +233,20 @@ module Railgun
     end
   end
 
+  # Returns the decoded AMP HTML from the Mail::Message object if it is available,
+  # otherwise nil.
+  #
+  # @param [Mail::Message] mail message to transform
+  #
+  # @return [String]
+  def extract_amp_html(mail)
+    begin
+      retrieve_amp_part(mail).body.decoded || nil
+    rescue
+      nil
+    end
+  end
+
   # Returns the mail object from the Mail::Message object if text part exists,
   # (decomposing multipart into individual format if necessary)
   # otherwise nil.
@@ -255,4 +270,18 @@ module Railgun
     return mail.html_part if mail.multipart?
     (mail.mime_type =~ /^text\/html$/i) && mail
   end
+
+  # Returns the mail object from the Mail::Message object if AMP part exists,
+  # (decomposing multipart into individual format if necessary)
+  # otherwise nil.
+  #
+  # @param [Mail::Message] mail message to transform
+  #
+  # @return [Mail::Message] mail message with its content-type = text/x-amp-html
+  def retrieve_amp_part(mail)
+    # AMP emails should always be multipart, with an HTML fallback.
+    return unless mail.multipart?
+
+    mail.find_first_mime_type('text/x-amp-html')
+  end
 end