add suppression endpoints

CHANGELOG.md

@@ -11,6 +11,7 @@ and this project adheres to
 ### Added
 
 - add `message_id` to `Email` and webhook `EmailBody` types (https://github.com/resend/resend-rust/pull/77)
+- `suppressions` endpoints
 
 
 ## [0.28.0] - 2026-07-05

Cargo.toml

@@ -40,6 +40,7 @@ rand = "0.10.2"
 getrandom = { version = "0.4.3", features = ["wasm_js"] }
 serde_json = "1.0.150"
 mailparse = "0.16.1"
+urlencoding = "2.1.3"
 
 [dev-dependencies]
 jiff = { version = "0.2.31", features = ["serde"] }

src/client.rs

@@ -12,7 +12,7 @@ use crate::{
     events::EventsSvc,
     logs::LogsSvc,
     oauth::OAuthSvc,
-    services::{AutomationsSvc, ReceivingSvc},
+    services::{AutomationsSvc, ReceivingSvc, SuppressionsSvc},
     webhooks::WebhookSvc,
 };
 use crate::{
@@ -59,6 +59,8 @@ pub struct Resend {
     pub events: EventsSvc,
     /// `Resend` APIs for `/oauth` endpoints.
     pub oauth: OAuthSvc,
+    /// `Resend` APIs for `/suppressions` endpoints.
+    pub suppressions: SuppressionsSvc,
 }
 
 impl Resend {
@@ -114,7 +116,8 @@ impl Resend {
             logs: LogsSvc(Arc::clone(&inner)),
             automations: AutomationsSvc(Arc::clone(&inner)),
             events: EventsSvc(Arc::clone(&inner)),
-            oauth: OAuthSvc(inner),
+            oauth: OAuthSvc(Arc::clone(&inner)),
+            suppressions: SuppressionsSvc(inner),
         }
     }
 

src/contacts.rs

@@ -55,6 +55,7 @@ impl ContactsSvc {
     /// <https://resend.com/docs/api-reference/contacts/get-contact>
     #[maybe_async::maybe_async]
     pub async fn get(&self, contact_id_or_email: &str) -> Result<Contact> {
+        let contact_id_or_email = urlencoding::encode(contact_id_or_email);
         let path = format!("/contacts/{contact_id_or_email}");
 
         let request = self.0.build(Method::GET, &path);
@@ -75,6 +76,7 @@ impl ContactsSvc {
         contact_id_or_email: &str,
         update: ContactChanges,
     ) -> Result<UpdateContactResponse> {
+        let contact_id_or_email = urlencoding::encode(contact_id_or_email);
         let path = format!("/contacts/{contact_id_or_email}");
 
         let request = self.0.build(Method::PATCH, &path);
@@ -89,6 +91,7 @@ impl ContactsSvc {
     /// <https://resend.com/docs/api-reference/contacts/delete-contact>
     #[maybe_async::maybe_async]
     pub async fn delete(&self, contact_id_or_email: &str) -> Result<bool> {
+        let contact_id_or_email = urlencoding::encode(contact_id_or_email);
         let path = format!("/contacts/{contact_id_or_email}");
 
         let request = self.0.build(Method::DELETE, &path);
@@ -129,6 +132,7 @@ impl ContactsSvc {
         contact_id_or_email: &str,
         list_opts: ListOptions<T>,
     ) -> Result<ListResponse<ContactTopic>> {
+        let contact_id_or_email = urlencoding::encode(contact_id_or_email);
         let path = format!("/contacts/{contact_id_or_email}/topics");
 
         let request = self.0.build(Method::GET, &path).query(&list_opts);
@@ -147,6 +151,7 @@ impl ContactsSvc {
         contact_id_or_email: &str,
         topics: impl Into<Vec<UpdateContactTopicOptions>>,
     ) -> Result<UpdateContactResponse> {
+        let contact_id_or_email = urlencoding::encode(contact_id_or_email);
         let path = format!("/contacts/{contact_id_or_email}/topics");
 
         let request = self.0.build(Method::PATCH, &path);
@@ -165,6 +170,7 @@ impl ContactsSvc {
         contact_id_or_email: &str,
         segment_id: &str,
     ) -> Result<AddContactSegmentResponse> {
+        let contact_id_or_email = urlencoding::encode(contact_id_or_email);
         let path = format!("/contacts/{contact_id_or_email}/segments/{segment_id}");
 
         let request = self.0.build(Method::POST, &path);
@@ -183,6 +189,7 @@ impl ContactsSvc {
         contact_id_or_email: &str,
         segment_id: &str,
     ) -> Result<RemoveContactSegmentResponse> {
+        let contact_id_or_email = urlencoding::encode(contact_id_or_email);
         let path = format!("/contacts/{contact_id_or_email}/segments/{segment_id}");
 
         let request = self.0.build(Method::DELETE, &path);
@@ -202,6 +209,7 @@ impl ContactsSvc {
         contact_id_or_email: &str,
         list_opts: ListOptions<T>,
     ) -> Result<ListResponse<Segment>> {
+        let contact_id_or_email = urlencoding::encode(contact_id_or_email);
         let path = format!("/contacts/{contact_id_or_email}/segments/");
 
         let request = self.0.build(Method::GET, &path).query(&list_opts);

src/lib.rs

@@ -72,6 +72,7 @@ mod oauth;
 pub mod rate_limit;
 mod receiving;
 mod segments;
+mod suppressions;
 mod templates;
 mod topics;
 mod webhooks;
@@ -90,6 +91,7 @@ pub mod services {
     pub use super::oauth::OAuthSvc;
     pub use super::receiving::ReceivingSvc;
     pub use super::segments::SegmentsSvc;
+    pub use super::suppressions::SuppressionsSvc;
     pub use super::templates::TemplateSvc;
     pub use super::topics::TopicsSvc;
 }
@@ -157,6 +159,12 @@ pub mod types {
         InboundEmailHtmlFormat, InboundEmailId,
     };
     pub use super::segments::types::{CreateSegmentResponse, Segment, SegmentId};
+    pub use super::suppressions::types::{
+        AddSuppressionOptions, AddSuppressionResponse, BatchAddSuppressionOptions,
+        BatchAddSuppressionResponse, BatchRemoveSuppressionOptions,
+        BatchRemoveSuppressionsResponse, EmailsSpecified, IdsSpecified, NotSpecified,
+        RemoveSuppressionResponse, Suppression, SuppressionId, SuppressionOrigin,
+    };
     pub use super::templates::types::{
         CreateTemplateOptions, CreateTemplateResponse, DeleteTemplateResponse,
         DuplicateTemplateResponse, PublishTemplateResponse, Template, TemplateEvent, TemplateId,