feat: support for custom_return_path

Author: drish

examples/domains.py

@@ -8,8 +8,9 @@
 
 
 create_params: resend.Domains.CreateParams = {
-    "name": "example.com",
+    "name": "drish.dev",
     "region": "us-east-1",
+    "custom_return_path": "outbound",
 }
 domain: resend.Domain = resend.Domains.create(params=create_params)
 print(domain)

resend/domains/_domains.py

@@ -60,6 +60,12 @@ class CreateParams(TypedDict):
         The region where emails will be sent from.
         Possible values: us-east-1' | 'eu-west-1' | 'sa-east-1' | 'ap-northeast-1'
         """
+        custom_return_path: NotRequired[str]
+        """
+        By default, Resend will use the `send` subdomain for the Return-Path address.
+        You can change this by setting the optional `custom_return_path` parameter
+        when creating a domain via the API or under Advanced options in the dashboard.
+        """
 
     @classmethod
     def create(cls, params: CreateParams) -> Domain:

tests/domains_test.py

@@ -62,6 +62,8 @@ def test_domains_create(self) -> None:
 
         create_params: resend.Domains.CreateParams = {
             "name": "example.com",
+            "region": "us-east-1",
+            "custom_return_path": "send",
         }
         domain = resend.Domains.create(params=create_params)
         assert domain["id"] == "4dd369bc-aa82-4ff3-97de-514ae3000ee0"