resend 1.5.0 → 1.7.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: a131df322ae7ac448440742ce3cda1487b763a094f1940710236cc1e4f76534d
-  data.tar.gz: bb824f2076b51bf7eb82dd9a75ba4bd86c2d15162e8a499ef6b6e66555c37b2b
+  metadata.gz: cc6ad8469a98068e64cbfb9d6c021058d7e640f32eb5617e839a796c46491d39
+  data.tar.gz: 499a33038351ff07315bd8b10f9a7e0c9387c6d5b04fe12cf7a6c7ce5d2a80e8
 SHA512:
-  metadata.gz: 01efcf455f3b05c468ee1aede05bfeae5d7040b3dae1b2faf6bc38571b422b273a097f1b7eeb41cdc6fcc55f0c2b2f81eb4718814897a982c61915b52aae7a15
-  data.tar.gz: 4259936777bb6815e5abca38babf4b399efe5e2a0dfa55d87e2b1536b9f85b344683e0e9ee84ef21978630ad4e41dd6bc709d59bb5def667b412a37781af86df
+  metadata.gz: 9e3709cd8c049cc638118353571fc575f124132d998d8b69580484f0e2cd9b60ec1ce3c7c981c195b69185e8c70970d7fe30477a8c35a787f62563d2eb7952a6
+  data.tar.gz: 4e1fe85c2ba097d460b3cdf56a7ce42da70e91398965bdd2b688581c34db0715c884e66bf330e32b48381afd66d505b03a0ac19758b7eeec1e26c0ff194306ef

data/CHANGELOG.md

@@ -5,6 +5,23 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [1.7.0] - 2026-07-31
+
+### Added
+
+- **Suppressions** - New `Resend::Suppressions` module to add (`add`), list (`list`), retrieve (`get`), and remove (`remove`) suppressed email addresses. `get` and `remove` accept either a suppression ID or the suppressed email address. `list` supports `origin` filtering (`bounce`, `complaint`, `manual`) plus the standard `limit`/`after`/`before` pagination params. New `Resend::Suppressions::Batch` module handles up to 100 addresses at a time via `add` and `remove`. ([#208](https://github.com/resend/resend-ruby/pull/208))
+
+### Changed
+
+- ⚠️ **404 responses now raise `Resend::Error::NotFoundError`** instead of `Resend::Error::InvalidRequestError`, matching the documented intent of the (previously unreachable) `NotFoundError` class. Code rescuing `Resend::Error` or `Resend::Error::ServerError` is unaffected; code rescuing `InvalidRequestError` specifically to catch 404s should rescue `NotFoundError` instead. ([#210](https://github.com/resend/resend-ruby/pull/210))
+
+## [1.6.0] - 2026-07-09
+
+### Added
+
+- **OAuth grants** - New `Resend::OAuthGrants` module to list (`GET /oauth/grants`) and revoke (`DELETE /oauth/grants/:id`) OAuth grants. `list` supports the standard `limit`/`after`/`before` pagination params. ([#197](https://github.com/resend/resend-ruby/pull/197))
+- **Domain claims** - New `Resend::Domains::Claims` module to claim a domain verified by another account (`create`), retrieve the latest claim (`get`), and trigger verification/ownership transfer (`verify`). ([#194](https://github.com/resend/resend-ruby/pull/194))
+
 ## [1.0.0] - 2025-10-31
 
 ### Overview
@@ -128,4 +145,6 @@ Resend::Segments.remove("segment_123")
 
 - Remove deprecated `send_email` method from `Resend::Emails` module (use `Resend::Emails.send` instead)
 
+[1.7.0]: https://github.com/resend/resend-ruby/compare/v1.6.0...v1.7.0
+[1.6.0]: https://github.com/resend/resend-ruby/compare/v1.5.0...v1.6.0
 [1.0.0]: https://github.com/resend/resend-ruby/compare/v0.26.0...v1.0.0

data/lib/resend/domains/claims.rb

@@ -0,0 +1,56 @@
+# frozen_string_literal: true
+
+module Resend
+  module Domains
+    # Domain Claims API wrapper
+    module Claims
+      class << self
+        #
+        # Start a claim for a domain that another Resend account has already verified.
+        # The domain is recreated under your account with fresh DKIM keys, so the
+        # previous account's DNS records cannot be reused. Returns a TXT record to add
+        # to your DNS to prove ownership. Uses the same request body as creating a domain.
+        #
+        # @param params [Hash] the parameters
+        # @option params [String] :name the name of the domain you want to claim (required)
+        # @option params [String] :region the region where emails will be sent from.
+        #   Possible values: 'us-east-1' | 'eu-west-1' | 'sa-east-1' | 'ap-northeast-1'
+        # @option params [String] :custom_return_path subdomain for the Return-Path address (default 'send')
+        # @option params [String] :tracking_subdomain the custom subdomain used for click and open tracking links
+        # @option params [Boolean] :click_tracking track clicks within the body of each HTML email
+        # @option params [Boolean] :open_tracking track the open rate of each email
+        #
+        # https://resend.com/docs/api-reference/domains/claim-domain
+        def create(params)
+          path = "domains/claim"
+          Resend::Request.new(path, params, "post").perform
+        end
+
+        #
+        # Retrieve the latest claim for the placeholder domain created by the claim.
+        #
+        # @param domain_id [String] the ID of the placeholder domain created by the claim
+        #
+        # https://resend.com/docs/api-reference/domains/get-domain-claim
+        def get(domain_id = "")
+          path = "domains/#{domain_id}/claim"
+          Resend::Request.new(path, {}, "get").perform
+        end
+
+        #
+        # Trigger asynchronous DNS verification and ownership transfer for a domain claim.
+        # The claim stays 'pending' while verification runs; poll `get` for status. Once
+        # 'completed', the transferred domain has new DKIM records that must be added to
+        # DNS and verified via Resend::Domains.verify.
+        #
+        # @param domain_id [String] the ID of the placeholder domain created by the claim
+        #
+        # https://resend.com/docs/api-reference/domains/verify-domain-claim
+        def verify(domain_id = "")
+          path = "domains/#{domain_id}/claim/verify"
+          Resend::Request.new(path, {}, "post").perform
+        end
+      end
+    end
+  end
+end

data/lib/resend/errors.rb

@@ -34,7 +34,7 @@ module Resend
 
     ERRORS = {
       401 => Resend::Error::InvalidRequestError,
-      404 => Resend::Error::InvalidRequestError,
+      404 => Resend::Error::NotFoundError,
       422 => Resend::Error::InvalidRequestError,
       429 => Resend::Error::RateLimitExceededError,
       400 => Resend::Error::InvalidRequestError,

data/lib/resend/oauth_grants.rb

@@ -0,0 +1,20 @@
+# frozen_string_literal: true
+
+module Resend
+  # oauth grants api wrapper
+  module OAuthGrants
+    class << self
+      # https://resend.com/docs/api-reference/oauth/list-grants
+      def list(params = {})
+        path = Resend::PaginationHelper.build_paginated_path("oauth/grants", params)
+        Resend::Request.new(path, {}, "get").perform
+      end
+
+      # https://resend.com/docs/api-reference/oauth/revoke-grant
+      def revoke(oauth_grant_id = "")
+        path = "oauth/grants/#{oauth_grant_id}"
+        Resend::Request.new(path, {}, "delete").perform
+      end
+    end
+  end
+end

data/lib/resend/suppressions/batch.rb

@@ -0,0 +1,44 @@
+# frozen_string_literal: true
+
+module Resend
+  module Suppressions
+    # Suppressions Batch API wrapper
+    module Batch
+      class << self
+        #
+        # Add up to 100 email addresses to the suppression list at once. Addresses that
+        # are already suppressed come back with their existing suppression instead of failing.
+        #
+        # @param params [Hash] the parameters
+        # @option params [Array<String>] :emails the email addresses to suppress (required, 1 to 100).
+        #   The API lowercases and trims them.
+        #
+        # https://resend.com/docs/api-reference/suppressions/add-suppressions
+        def add(params)
+          Resend::Request.new("suppressions/batch/add", params, "post").perform
+        end
+
+        #
+        # Remove up to 100 suppressions at once, either by email address or by
+        # suppression ID. Provide exactly one of `emails` or `ids`.
+        #
+        # @param params [Hash] the parameters
+        # @option params [Array<String>] :emails the email addresses to remove (1 to 100)
+        # @option params [Array<String>] :ids the suppression IDs to remove (1 to 100), as UUIDs
+        #
+        # https://resend.com/docs/api-reference/suppressions/remove-suppressions
+        def remove(params)
+          normalized = params.transform_keys(&:to_sym)
+          emails = normalized[:emails]
+          ids = normalized[:ids]
+          raise ArgumentError, "Missing required `emails` or `ids` field" if emails.nil? && ids.nil?
+          raise ArgumentError, "Provide either `emails` or `ids`, but not both" if !emails.nil? && !ids.nil?
+
+          # The API rejects a null `emails`/`ids`, so the unused key is omitted rather than sent as nil.
+          body = emails.nil? ? { ids: ids } : { emails: emails }
+          Resend::Request.new("suppressions/batch/remove", body, "post").perform
+        end
+      end
+    end
+  end
+end

data/lib/resend/suppressions.rb

@@ -0,0 +1,64 @@
+# frozen_string_literal: true
+
+module Resend
+  # Suppressions API wrapper
+  module Suppressions
+    class << self
+      #
+      # Add an email address to the suppression list. Suppressed addresses are
+      # skipped by future sends. Adding an address that is already suppressed
+      # succeeds and returns the existing suppression.
+      #
+      # @param params [Hash] the parameters
+      # @option params [String] :email the email address to suppress (required).
+      #   The API lowercases and trims it.
+      #
+      # https://resend.com/docs/api-reference/suppressions/add-suppression
+      def add(params)
+        Resend::Request.new("suppressions", params, "post").perform
+      end
+
+      #
+      # Retrieve a list of suppressions. Each entry has `id`, `email`, `origin`,
+      # `source_id` and `created_at`; unlike `get`, list entries carry no `object` key.
+      #
+      # @param params [Hash] optional filtering and pagination parameters
+      # @option params [String] :origin filter by origin: 'bounce', 'complaint' or 'manual'
+      # @option params [Integer] :limit number of results to return (1-100)
+      # @option params [String] :after cursor for forward pagination
+      # @option params [String] :before cursor for backward pagination
+      #
+      # https://resend.com/docs/api-reference/suppressions/list-suppressions
+      def list(params = {})
+        path = Resend::PaginationHelper.build_paginated_path("suppressions", params)
+        Resend::Request.new(path, {}, "get").perform
+      end
+
+      #
+      # Retrieve a single suppression. The API returns 404 'Suppression not found'
+      # when the address or ID is not suppressed.
+      #
+      # @param id_or_email [String] the suppression ID or the suppressed email address (required)
+      #
+      # https://resend.com/docs/api-reference/suppressions/get-suppression
+      def get(id_or_email)
+        raise ArgumentError, "Missing required `id_or_email` field" if id_or_email.nil? || id_or_email.empty?
+
+        Resend::Request.new("suppressions/#{ERB::Util.url_encode(id_or_email)}", {}, "get").perform
+      end
+
+      #
+      # Remove a single suppression, which allows sending to that address again.
+      # The API returns 404 'Suppression not found' when the address or ID is not suppressed.
+      #
+      # @param id_or_email [String] the suppression ID or the suppressed email address (required)
+      #
+      # https://resend.com/docs/api-reference/suppressions/remove-suppression
+      def remove(id_or_email)
+        raise ArgumentError, "Missing required `id_or_email` field" if id_or_email.nil? || id_or_email.empty?
+
+        Resend::Request.new("suppressions/#{ERB::Util.url_encode(id_or_email)}", {}, "delete").perform
+      end
+    end
+  end
+end

data/lib/resend/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Resend
-  VERSION = "1.5.0"
+  VERSION = "1.7.0"
 end

data/lib/resend.rb

@@ -7,6 +7,7 @@ require "resend/version"
 require "httparty"
 require "json"
 require "cgi"
+require "erb"
 require "resend/errors"
 require "resend/response"
 require "resend/client"
@@ -25,6 +26,7 @@ require "resend/contacts/segments"
 require "resend/contacts/topics"
 require "resend/contact_properties"
 require "resend/domains"
+require "resend/domains/claims"
 require "resend/emails"
 require "resend/templates"
 require "resend/emails/receiving"
@@ -33,9 +35,12 @@ require "resend/emails/receiving/attachments"
 require "resend/logs"
 require "resend/topics"
 require "resend/webhooks"
+require "resend/oauth_grants"
 require "resend/automations"
 require "resend/automations/runs"
 require "resend/events"
+require "resend/suppressions"
+require "resend/suppressions/batch"
 
 # Rails
 require "resend/railtie" if defined?(Rails) && defined?(ActionMailer)

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: resend
 version: !ruby/object:Gem::Version
-  version: 1.5.0
+  version: 1.7.0
 platform: ruby
 authors:
 - Derich Pacheco
@@ -57,6 +57,7 @@ files:
 - lib/resend/contacts/segments.rb
 - lib/resend/contacts/topics.rb
 - lib/resend/domains.rb
+- lib/resend/domains/claims.rb
 - lib/resend/emails.rb
 - lib/resend/emails/attachments.rb
 - lib/resend/emails/receiving.rb
@@ -66,11 +67,14 @@ files:
 - lib/resend/logs.rb
 - lib/resend/mailer.rb
 - lib/resend/multipart_request.rb
+- lib/resend/oauth_grants.rb
 - lib/resend/pagination_helper.rb
 - lib/resend/railtie.rb
 - lib/resend/request.rb
 - lib/resend/response.rb
 - lib/resend/segments.rb
+- lib/resend/suppressions.rb
+- lib/resend/suppressions/batch.rb
 - lib/resend/templates.rb
 - lib/resend/topics.rb
 - lib/resend/version.rb