mailtrap 2.13.0 → 2.15.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 4e1407023f85d4f46bb34447e8ed5a9cfe5343461ed38008690d9d92006929d1
-  data.tar.gz: 3efa540454828966a9e6ff4439410d73e69c0c41d8e1e227943ebf1a7cc122dc
+  metadata.gz: ba78e8e22574eb5404c0e4d14f5a4ad764dabc559a3fd58bc0ae9ba46a49ea3f
+  data.tar.gz: da43055430599e2f496fc794fb145bacb7d589785b2387f6296ed978db57c4ac
 SHA512:
-  metadata.gz: 22ae6dbfc35ff8228eb16d4c3444b9e93eb680f6c59bd4b7b0f2d37629b8c471943ea807c583cc50f50c64267920c67eb80c52a2d8e3dcc7b57379e58c7e7b80
-  data.tar.gz: e7eb3ff7a9592ffc0918a63c9b75dbe7c81342642c624ded9e2d359136e620f0fc32a6889cee0fef5bf58cd66037ed1370c1b7512d99c623f1f9e033dd7971f4
+  metadata.gz: 7e5eb305e76d483f99711da0d2c913b1fdab00c8010bd55b697171284bd712d78545096dd5af9ffeab6886c06518b8c8f515edf42cf0b3e41dab4d98f7265a5b
+  data.tar.gz: e9c400428a9e86678a2b6fd6c6ef6ddbada0726ecfac29e9b254021b6a9f9143f912e81f6ba967084fa94c16c4ac19aaaa7e01699ad98a31ef4d3e934d37cd9d

data/CHANGELOG.md

@@ -1,3 +1,20 @@
+## [2.15.0] - 2026-08-28
+
+## What's Changed
+* Accept all sending domain update options by @mklocek in https://github.com/mailtrap/mailtrap-ruby/pull/126
+* Add tracking opt-outs and create-suppression endpoints by @mklocek in https://github.com/mailtrap/mailtrap-ruby/pull/127
+
+
+**Full Changelog**: https://github.com/mailtrap/mailtrap-ruby/compare/v2.14.0...v2.15.0
+
+## [2.14.0] - 2026-08-14
+
+## What's Changed
+* MT-22401: Add Email Campaigns API by @Rabsztok in https://github.com/mailtrap/mailtrap-ruby/pull/119
+
+
+**Full Changelog**: https://github.com/mailtrap/mailtrap-ruby/compare/v2.13.0...v2.14.0
+
 ## [2.13.0] - 2026-08-04
 
 ## What's Changed

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    mailtrap (2.13.0)
+    mailtrap (2.15.0)
       base64
 
 GEM

data/README.md

@@ -179,6 +179,8 @@ Email API:
 - Sending Stats API – [`stats_api.rb`](examples/stats_api.rb)
 - Email Logs API – [`email_logs_api.rb`](examples/email_logs_api.rb)
 - Webhooks API – [`webhooks_api.rb`](examples/webhooks_api.rb)
+- Suppressions API – [`suppressions_api.rb`](examples/suppressions_api.rb)
+- Tracking Opt-outs API – [`tracking_opt_outs_api.rb`](examples/tracking_opt_outs_api.rb)
 
 Email Sandbox (Testing):
 
@@ -198,6 +200,10 @@ Contact management:
 
 - Contacts CRUD & Listing – [`contacts_api.rb`](examples/contacts_api.rb)
 
+Email marketing:
+
+- Email Campaigns CRUD, Lifecycle Actions & Stats – [`email_campaigns_api.rb`](examples/email_campaigns_api.rb)
+
 General:
 
 - Accounts API – [`accounts_api.rb`](examples/accounts_api.rb)

data/lib/mailtrap/account_accesses_api.rb

@@ -7,8 +7,6 @@ module Mailtrap
   class AccountAccessesAPI
     include BaseAPI
 
-    attr_reader :account_id
-
     self.response_class = AccountAccess
 
     # Retrieves a list of account accesses with optional filtering by domain, inbox, or project IDs

data/lib/mailtrap/accounts_api.rb

@@ -9,8 +9,6 @@ module Mailtrap
 
     self.response_class = Account
 
-    attr_reader :client
-
     # @param client [Mailtrap::Client] The client instance
     # @raise [ArgumentError] If account_id is nil
     def initialize(client = Mailtrap::Client.new)

data/lib/mailtrap/email_campaign.rb

@@ -0,0 +1,98 @@
+# frozen_string_literal: true
+
+module Mailtrap
+  # Data Transfer Object for Email Campaign Stats
+  #
+  # Aggregated campaign performance metrics. All counts and rates are +0+ when the
+  # campaign has not been started.
+  # @see https://api-docs.mailtrap.io/docs/mailtrap-api-docs/email-campaigns
+  # @attr_reader delivery_count [Integer] Number of delivered messages
+  # @attr_reader open_count [Integer] Number of opened messages
+  # @attr_reader click_count [Integer] Number of clicked messages
+  # @attr_reader bounce_count [Integer] Number of bounced messages
+  # @attr_reader unsubscription_count [Integer] Number of unsubscriptions
+  # @attr_reader sent_count [Integer] Number of sent messages
+  # @attr_reader spam_count [Integer] Number of spam complaints
+  # @attr_reader delivery_rate [Float] Share of sent messages that were delivered (0–1)
+  # @attr_reader open_rate [Float] Share of delivered messages that were opened (0–1)
+  # @attr_reader click_rate [Float] Share of delivered messages that were clicked (0–1)
+  # @attr_reader bounce_rate [Float] Share of sent messages that bounced (0–1)
+  # @attr_reader spam_rate [Float] Share of sent messages marked as spam (0–1)
+  # @attr_reader unsubscription_rate [Float] Share of delivered messages that unsubscribed (0–1)
+  EmailCampaignStats = Struct.new(
+    :delivery_count,
+    :open_count,
+    :click_count,
+    :bounce_count,
+    :unsubscription_count,
+    :sent_count,
+    :spam_count,
+    :delivery_rate,
+    :open_rate,
+    :click_rate,
+    :bounce_rate,
+    :spam_rate,
+    :unsubscription_rate,
+    keyword_init: true
+  )
+
+  # Data Transfer Object for Email Campaign
+  # @see https://api-docs.mailtrap.io/docs/mailtrap-api-docs/email-campaigns
+  # @attr_reader id [Integer] The email campaign ID
+  # @attr_reader domain_id [Integer] ID of the sending domain used for the campaign,
+  #   as returned by the Sending Domains endpoints
+  # @attr_reader domain_name [String] Name of the sending domain used for the campaign
+  # @attr_reader name [String] Campaign name
+  # @attr_reader from_local_part [String] Local part (before the @) of the From address
+  # @attr_reader from_display_name [String] Display name shown in the From header
+  # @attr_reader reply_to [Hash, nil] Reply-To address parts (+display_name+, +local_part+, +domain+)
+  # @attr_reader current_state [String] Lifecycle state (+draft+, +scheduled+, +started+, +queued+,
+  #   +paused+, +terminating+, +under_review+, +finished+, +failed+, +failed_immediately+)
+  # @attr_reader current_state_metadata [Hash, nil] Metadata about the most recent state transition
+  #   (+reason+, +error+, +errors+ as an array of +{message, rcpt_index}+ objects, +scheduled_at+)
+  # @attr_reader created_at [String] The creation timestamp
+  # @attr_reader updated_at [String] The last update timestamp
+  # @attr_reader last_started_at [String, nil] When the campaign was last started, or +nil+
+  # @attr_reader last_started_at_date [String, nil] Date the campaign was last started, present only when started
+  # @attr_reader recipient_total_count [Integer, nil] Total number of recipients,
+  #   or +nil+ until the audience is resolved
+  # @attr_reader contact_list_ids [Array<Integer>] IDs of the contact lists included in the campaign's audience
+  # @attr_reader contact_segment_ids [Array<Integer>] IDs of the contact segments included in the campaign's audience
+  # @attr_reader delivery_mode [String] How the campaign is delivered (+rapid+ or +gradual+)
+  # @attr_reader delivery_options [Hash, nil] Delivery throttling options (+emails_per_hour+)
+  # @attr_reader template [Hash, nil] The campaign template (+id+, +subject+, +merge_tags+,
+  #   +body_html+, +body_text+; bodies are omitted on list responses)
+  EmailCampaign = Struct.new(
+    :id,
+    :domain_id,
+    :domain_name,
+    :name,
+    :from_local_part,
+    :from_display_name,
+    :reply_to,
+    :current_state,
+    :current_state_metadata,
+    :created_at,
+    :updated_at,
+    :last_started_at,
+    :last_started_at_date,
+    :recipient_total_count,
+    :contact_list_ids,
+    :contact_segment_ids,
+    :delivery_mode,
+    :delivery_options,
+    :template,
+    keyword_init: true
+  )
+
+  # Response from listing email campaigns (paginated)
+  # @see https://api-docs.mailtrap.io/docs/mailtrap-api-docs/email-campaigns
+  # @attr_reader data [Array<EmailCampaign>] Page of email campaigns, newest first
+  # @attr_reader pagination [Hash] Page-token pagination metadata
+  #   (+token+, +prev_token+, +next_token+, +first_url+, +prev_url+, +current_url+, +next_url+)
+  EmailCampaignsListResponse = Struct.new(
+    :data,
+    :pagination,
+    keyword_init: true
+  )
+end

data/lib/mailtrap/email_campaigns_api.rb

@@ -0,0 +1,187 @@
+# frozen_string_literal: true
+
+require_relative 'base_api'
+require_relative 'email_campaign'
+
+module Mailtrap
+  class EmailCampaignsAPI
+    include BaseAPI
+
+    self.supported_options = %i[
+      name
+      domain_id
+      from_display_name
+      from_local_part
+      reply_to
+      template_attributes
+      delivery_mode
+      delivery_options
+      contact_list_ids
+      contact_segment_ids
+    ].freeze
+
+    self.response_class = EmailCampaign
+
+    # @param client [Mailtrap::Client] The client instance
+    def initialize(client = Mailtrap::Client.new)
+      @client = client
+    end
+
+    # Lists email campaigns for the account, newest first
+    # @param per_page [Integer, nil] Number of campaigns per page (max 100, default 50)
+    # @param search [String, nil] Filter campaigns by name
+    # @param token [Integer, nil] Page number to retrieve (page-token pagination, default 1)
+    # @return [EmailCampaignsListResponse] The page of campaigns and pagination metadata
+    # @!macro api_errors
+    def list(per_page: nil, search: nil, token: nil)
+      query_params = {}
+      query_params[:per_page] = per_page unless per_page.nil?
+      query_params[:search] = search unless search.nil?
+      query_params[:token] = token unless token.nil?
+
+      response = client.get(base_path, query_params)
+
+      EmailCampaignsListResponse.new(
+        data: Array(response[:data]).map { |item| build_entity(item, response_class) },
+        pagination: response[:pagination]
+      )
+    end
+
+    # Retrieves a specific email campaign
+    # @param email_campaign_id [Integer] The email campaign ID
+    # @return [EmailCampaign] Email campaign object
+    # @!macro api_errors
+    def get(email_campaign_id)
+      base_get(email_campaign_id)
+    end
+
+    # Creates a new email campaign in the +draft+ state
+    # @param [Hash] options The parameters to create
+    # @option options [String] :name Campaign name (required)
+    # @option options [Integer] :domain_id ID of the verified sending domain (required),
+    #   as returned by the Sending Domains endpoints
+    # @option options [String] :from_display_name Display name shown in the From header
+    # @option options [String] :from_local_part Local part (before the @) of the From address (required)
+    # @option options [Hash] :reply_to Reply-To address parts (+display_name+, +local_part+, +domain+)
+    # @option options [Hash] :template_attributes Template attributes (+subject+ (required),
+    #   +body_html+, +body_text+, +merge_tags+)
+    # @option options [String] :delivery_mode How the campaign is delivered (+rapid+ or +gradual+)
+    # @option options [Hash] :delivery_options Delivery throttling options (+emails_per_hour+),
+    #   applies when +delivery_mode+ is +gradual+
+    # @option options [Array<Integer>] :contact_list_ids IDs of contact lists to send to
+    # @option options [Array<Integer>] :contact_segment_ids IDs of contact segments to send to
+    # @return [EmailCampaign] Created email campaign
+    # @!macro api_errors
+    # @raise [ArgumentError] If invalid options are provided
+    def create(options)
+      base_create(options)
+    end
+
+    # Updates an existing +draft+ email campaign. Only the provided attributes are changed;
+    # +template_attributes+ sub-fields are also updated partially, in place.
+    # @param email_campaign_id [Integer] The email campaign ID
+    # @param [Hash] options The parameters to update; accepts the same fields as {#create}
+    # @option options [String] :name Campaign name
+    # @option options [Integer] :domain_id ID of the verified sending domain,
+    #   as returned by the Sending Domains endpoints
+    # @option options [String] :from_display_name Display name shown in the From header
+    # @option options [String] :from_local_part Local part (before the @) of the From address
+    # @option options [Hash] :reply_to Reply-To address parts (+display_name+, +local_part+, +domain+)
+    # @option options [Hash] :template_attributes Template attributes (+subject+, +body_html+,
+    #   +body_text+, +merge_tags+)
+    # @option options [String] :delivery_mode How the campaign is delivered (+rapid+ or +gradual+)
+    # @option options [Hash] :delivery_options Delivery throttling options (+emails_per_hour+),
+    #   applies when +delivery_mode+ is +gradual+
+    # @option options [Array<Integer>] :contact_list_ids IDs of contact lists to send to
+    # @option options [Array<Integer>] :contact_segment_ids IDs of contact segments to send to
+    # @return [EmailCampaign] Updated email campaign
+    # @!macro api_errors
+    # @raise [ArgumentError] If invalid options are provided
+    def update(email_campaign_id, options)
+      base_update(email_campaign_id, options)
+    end
+
+    # Deletes an email campaign. Only a campaign in the +draft+ state can be deleted.
+    # @param email_campaign_id [Integer] The email campaign ID
+    # @return [nil]
+    # @!macro api_errors
+    def delete(email_campaign_id)
+      base_delete(email_campaign_id)
+    end
+
+    # Starts sending a +draft+ campaign immediately
+    # @param email_campaign_id [Integer] The email campaign ID
+    # @return [EmailCampaign] The started email campaign
+    # @!macro api_errors
+    def start(email_campaign_id)
+      perform_action(email_campaign_id, :start)
+    end
+
+    # Schedules a +draft+ campaign to start sending at a future time.
+    # The time is reported back in +current_state_metadata.scheduled_at+.
+    # @param email_campaign_id [Integer] The email campaign ID
+    # @param datetime [String] When to send the campaign (ISO 8601); must be in the future
+    #   and no more than 1 month ahead
+    # @return [EmailCampaign] The scheduled email campaign
+    # @!macro api_errors
+    def schedule(email_campaign_id, datetime)
+      perform_action(email_campaign_id, :schedule, { datetime: })
+    end
+
+    # Cancels a +scheduled+ campaign, returning it to the +draft+ state
+    # @param email_campaign_id [Integer] The email campaign ID
+    # @return [EmailCampaign] The cancelled email campaign
+    # @!macro api_errors
+    def cancel(email_campaign_id)
+      perform_action(email_campaign_id, :cancel)
+    end
+
+    # Terminates a campaign that is currently sending (+started+, +queued+, or +paused+),
+    # aborting the in-flight send
+    # @param email_campaign_id [Integer] The email campaign ID
+    # @return [EmailCampaign] The terminated email campaign
+    # @!macro api_errors
+    def terminate(email_campaign_id)
+      perform_action(email_campaign_id, :terminate)
+    end
+
+    # Resets a +scheduled+ campaign back to the +draft+ state
+    # @param email_campaign_id [Integer] The email campaign ID
+    # @return [EmailCampaign] The reset email campaign
+    # @!macro api_errors
+    def reset(email_campaign_id)
+      perform_action(email_campaign_id, :reset)
+    end
+
+    # Retrieves aggregated performance statistics for an email campaign.
+    # By default statistics are aggregated since the campaign was last started.
+    # @param email_campaign_id [Integer] The email campaign ID
+    # @param start_date [String, nil] Start of the aggregation window (inclusive), +YYYY-MM-DD+
+    # @param end_date [String, nil] End of the aggregation window (inclusive), +YYYY-MM-DD+
+    # @return [EmailCampaignStats] Aggregated campaign statistics
+    # @!macro api_errors
+    def stats(email_campaign_id, start_date: nil, end_date: nil)
+      query_params = {}
+      query_params[:start_date] = start_date unless start_date.nil?
+      query_params[:end_date] = end_date unless end_date.nil?
+
+      response = client.get("#{base_path}/#{email_campaign_id}/stats", query_params)
+      build_entity(response[:data], EmailCampaignStats)
+    end
+
+    private
+
+    def perform_action(email_campaign_id, action, body = nil)
+      response = client.post("#{base_path}/#{email_campaign_id}/#{action}", body)
+      handle_response(response)
+    end
+
+    def base_path
+      '/api/email_campaigns'
+    end
+
+    def handle_response(response)
+      build_entity(response[:data], response_class)
+    end
+  end
+end

data/lib/mailtrap/inbound_folders_api.rb

@@ -10,7 +10,6 @@ module Mailtrap
     self.supported_options = %i[name]
     self.response_class = InboundFolder
 
-    # Inbound is scoped to the token's account, so no account_id is required.
     # @param client [Mailtrap::Client] The client instance
     def initialize(client = Mailtrap::Client.new)
       @client = client

data/lib/mailtrap/inbound_inboxes_api.rb

@@ -12,7 +12,6 @@ module Mailtrap
     CREATE_OPTIONS = %i[name domain_id].freeze
     UPDATE_OPTIONS = %i[name].freeze
 
-    # Inbound is scoped to the token's account, so no account_id is required.
     # @param client [Mailtrap::Client] The client instance
     def initialize(client = Mailtrap::Client.new)
       @client = client

data/lib/mailtrap/inbound_messages_api.rb

@@ -14,7 +14,6 @@ module Mailtrap
 
     SEND_OPTIONS = %i[from to cc bcc reply_to text html category attachments headers custom_variables].freeze
 
-    # Inbound is scoped to the token's account, so no account_id is required.
     # @param client [Mailtrap::Client] The client instance
     def initialize(client = Mailtrap::Client.new)
       @client = client

data/lib/mailtrap/inbound_threads_api.rb

@@ -12,7 +12,6 @@ module Mailtrap
 
     self.response_class = InboundThread
 
-    # Inbound is scoped to the token's account, so no account_id is required.
     # @param client [Mailtrap::Client] The client instance
     def initialize(client = Mailtrap::Client.new)
       @client = client

data/lib/mailtrap/sandbox_attachments_api.rb

@@ -7,7 +7,7 @@ module Mailtrap
   class SandboxAttachmentsAPI
     include BaseAPI
 
-    attr_reader :account_id, :inbox_id, :sandbox_message_id, :client
+    attr_reader :inbox_id, :sandbox_message_id
 
     self.response_class = SandboxAttachment
 

data/lib/mailtrap/sandbox_messages_api.rb

@@ -7,7 +7,7 @@ module Mailtrap
   class SandboxMessagesAPI
     include BaseAPI
 
-    attr_reader :account_id, :inbox_id, :client
+    attr_reader :inbox_id
 
     self.supported_options = %i[is_read]
 

data/lib/mailtrap/sending_domain.rb

@@ -12,6 +12,7 @@ module Mailtrap
   # @attr_reader dns_records [Array] The DNS records for the sending domain
   # @attr_reader open_tracking_enabled [Boolean] Whether open tracking is enabled
   # @attr_reader click_tracking_enabled [Boolean] Whether click tracking is enabled
+  # @attr_reader tracking_opt_out_enabled [Boolean] Whether the tracking opt-out link is enabled
   # @attr_reader auto_unsubscribe_link_enabled [Boolean] Whether auto unsubscribe link is enabled
   # @attr_reader custom_domain_tracking_enabled [Boolean] Whether custom domain tracking is enabled
   # @attr_reader health_alerts_enabled [Boolean] Whether health alerts are enabled
@@ -31,6 +32,7 @@ module Mailtrap
     :dns_records,
     :open_tracking_enabled,
     :click_tracking_enabled,
+    :tracking_opt_out_enabled,
     :auto_unsubscribe_link_enabled,
     :custom_domain_tracking_enabled,
     :health_alerts_enabled,

data/lib/mailtrap/sending_domains_api.rb

@@ -7,7 +7,13 @@ module Mailtrap
   class SendingDomainsAPI
     include BaseAPI
 
-    self.supported_options = %i[open_tracking_enabled click_tracking_enabled auto_unsubscribe_link_enabled]
+    self.supported_options = %i[
+      open_tracking_enabled
+      click_tracking_enabled
+      tracking_opt_out_enabled
+      auto_unsubscribe_link_enabled
+      inbound_enabled
+    ]
 
     self.response_class = SendingDomain
 
@@ -50,7 +56,9 @@ module Mailtrap
     # @param [Hash] options The parameters to update
     # @option options [Boolean] :open_tracking_enabled Enable open tracking for emails sent from this domain
     # @option options [Boolean] :click_tracking_enabled Enable click tracking for links in emails sent from this domain
+    # @option options [Boolean] :tracking_opt_out_enabled Enable the tracking opt-out link in tracked emails
     # @option options [Boolean] :auto_unsubscribe_link_enabled Automatically add an unsubscribe link to emails
+    # @option options [Boolean] :inbound_enabled Enable inbound email for this domain
     # @return [SendingDomain] Updated sending domain
     # @!macro api_errors
     # @raise [ArgumentError] If invalid options are provided

data/lib/mailtrap/suppressions_api.rb

@@ -7,6 +7,8 @@ module Mailtrap
   class SuppressionsAPI
     include BaseAPI
 
+    self.supported_options = %i[email domain_id sending_stream type].freeze
+
     self.response_class = Suppression
 
     # Lists all suppressions for the account
@@ -20,12 +22,28 @@ module Mailtrap
       base_list(query_params)
     end
 
+    # Adds an email address to the account's suppression list
+    # @param [Hash] options The suppression attributes
+    # @option options [String] :email Email address to suppress
+    # @option options [Integer] :domain_id ID of the domain to suppress this email for
+    # @option options [String] :sending_stream The sending stream to suppress for: "transactional" or "bulk"
+    # @option options [String] :type Reason for the suppression, defaults to "manual import" when omitted
+    # @return [Suppression] Created suppression
+    # @!macro api_errors
+    # @raise [ArgumentError] If invalid options are provided
+    def create(options)
+      validate_options!(options, supported_options)
+      response = client.post(base_path, options)
+      build_entity(response[:data], Suppression)
+    end
+
     # Deletes a suppression
     # @param suppression_id [String] The suppression UUID
-    # @return nil
+    # @return [Suppression] The deleted suppression
     # @!macro api_errors
     def delete(suppression_id)
-      client.delete("#{base_path}/#{suppression_id}")
+      response = client.delete("#{base_path}/#{suppression_id}")
+      build_entity(response, Suppression)
     end
 
     private

data/lib/mailtrap/tracking_opt_out.rb

@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+
+module Mailtrap
+  # Data Transfer Object for Tracking Opt-out
+  # @see https://docs.mailtrap.io/developers/management/tracking-opt-outs
+  # @attr_reader id [String] The tracking opt-out UUID
+  # @attr_reader email [String] The email address opted out of tracking
+  # @attr_reader created_at [String] The creation timestamp
+  # @attr_reader domain_name [String, nil] Sending domain the tracking opt-out applies to
+  TrackingOptOut = Struct.new(
+    :id,
+    :email,
+    :created_at,
+    :domain_name,
+    keyword_init: true
+  )
+end

data/lib/mailtrap/tracking_opt_outs_api.rb

@@ -0,0 +1,70 @@
+# frozen_string_literal: true
+
+require_relative 'base_api'
+require_relative 'tracking_opt_out'
+require_relative 'tracking_opt_outs_list_response'
+
+module Mailtrap
+  class TrackingOptOutsAPI
+    include BaseAPI
+
+    self.supported_options = %i[email domain_id].freeze
+
+    self.response_class = TrackingOptOut
+
+    # @param client [Mailtrap::Client] The client instance
+    def initialize(client = Mailtrap::Client.new)
+      @client = client
+    end
+
+    # Lists email addresses that have opted out of open and click tracking
+    # @param email [String, nil] Filter by exact email address (case-insensitive)
+    # @param start_time [String, nil] Only opt-outs created at or after this ISO 8601 timestamp
+    # @param end_time [String, nil] Only opt-outs created at or before this ISO 8601 timestamp
+    # @param last_id [String, nil] Cursor from the previous response's +last_id+ for the next page
+    # @return [TrackingOptOutsListResponse] The page of tracking opt-outs and the next cursor
+    # @!macro api_errors
+    def list(email: nil, start_time: nil, end_time: nil, last_id: nil)
+      query_params = {}
+      query_params[:email] = email unless email.nil?
+      query_params[:start_time] = start_time unless start_time.nil?
+      query_params[:end_time] = end_time unless end_time.nil?
+      query_params[:last_id] = last_id unless last_id.nil?
+
+      response = client.get(base_path, query_params)
+
+      TrackingOptOutsListResponse.new(
+        data: Array(response[:data]).map { |item| build_entity(item, TrackingOptOut) },
+        last_id: response[:last_id]
+      )
+    end
+
+    # Adds an email address to the tracking opt-out list for a sending domain
+    # @param [Hash] options The tracking opt-out attributes
+    # @option options [String] :email Email address to opt out of tracking
+    # @option options [Integer] :domain_id ID of the sending domain the opt-out applies to
+    # @return [TrackingOptOut] Created tracking opt-out
+    # @!macro api_errors
+    # @raise [ArgumentError] If invalid options are provided
+    def create(options)
+      validate_options!(options, supported_options)
+      response = client.post(base_path, options)
+      build_entity(response[:data], TrackingOptOut)
+    end
+
+    # Removes an email address from the tracking opt-out list
+    # @param tracking_opt_out_id [String] The tracking opt-out UUID
+    # @return [TrackingOptOut] The deleted tracking opt-out
+    # @!macro api_errors
+    def delete(tracking_opt_out_id)
+      response = client.delete("#{base_path}/#{tracking_opt_out_id}")
+      build_entity(response, TrackingOptOut)
+    end
+
+    private
+
+    def base_path
+      '/api/tracking_opt_outs'
+    end
+  end
+end

data/lib/mailtrap/tracking_opt_outs_list_response.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+module Mailtrap
+  # Data Transfer Object for a paginated list of tracking opt-outs
+  # @see https://docs.mailtrap.io/developers/management/tracking-opt-outs
+  # @attr_reader data [Array<TrackingOptOut>] The tracking opt-outs on this page
+  # @attr_reader last_id [String, nil] Cursor for the next page, or nil if this is the last page
+  TrackingOptOutsListResponse = Struct.new(
+    :data,
+    :last_id,
+    keyword_init: true
+  )
+end

data/lib/mailtrap/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Mailtrap
-  VERSION = '2.13.0'
+  VERSION = '2.15.0'
 end

data/lib/mailtrap.rb

@@ -18,6 +18,8 @@ require_relative 'mailtrap/contact_imports_api'
 require_relative 'mailtrap/contact_exports_api'
 require_relative 'mailtrap/contact_events_api'
 require_relative 'mailtrap/suppressions_api'
+require_relative 'mailtrap/tracking_opt_outs_api'
+require_relative 'mailtrap/email_campaigns_api'
 require_relative 'mailtrap/sending_domains_api'
 require_relative 'mailtrap/company_info_api'
 require_relative 'mailtrap/email_logs_api'

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: mailtrap
 version: !ruby/object:Gem::Version
-  version: 2.13.0
+  version: 2.15.0
 platform: ruby
 authors:
 - Railsware Products Studio LLC
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-08-04 00:00:00.000000000 Z
+date: 2026-08-28 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: base64
@@ -72,6 +72,8 @@ files:
 - lib/mailtrap/contact_lists_api.rb
 - lib/mailtrap/contacts_api.rb
 - lib/mailtrap/contacts_import_request.rb
+- lib/mailtrap/email_campaign.rb
+- lib/mailtrap/email_campaigns_api.rb
 - lib/mailtrap/email_log_event.rb
 - lib/mailtrap/email_log_event_details.rb
 - lib/mailtrap/email_log_message.rb
@@ -115,6 +117,9 @@ files:
 - lib/mailtrap/sub_accounts_api.rb
 - lib/mailtrap/suppression.rb
 - lib/mailtrap/suppressions_api.rb
+- lib/mailtrap/tracking_opt_out.rb
+- lib/mailtrap/tracking_opt_outs_api.rb
+- lib/mailtrap/tracking_opt_outs_list_response.rb
 - lib/mailtrap/version.rb
 - lib/mailtrap/webhook.rb
 - lib/mailtrap/webhooks.rb