CHANGELOG.md

Changelog

All notable changes to this project will be documented in this file.

The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

0.21.1 - 2026-02-23

Added

• Many fields that were previously private in events are now public

0.21.0 - 2026-02-03

Changed

• The following fields from InboundAttachment are not Options:
  • filename
  • content_disposition
  • size

0.20.0 - 2026-01-18

Changed

• Renamed ErrorKind::ValidationError403 -> ErrorKind::ValidationError403Email

Added

• ErrorKind::ValidationError403Domain
• EmailEventType::EmailSuppressed, EmailEventType::EmailScheduled

Fixed

• ListResponse::is_empty and ListResponse::len are no longer const (#33)

0.19.0 - 2025-10-29

Added

• optional text, html fields in Broadcast.
• 7 new Templates endpoints
• 5 new Topics endpoints
  • and 2 new contact-topic endpoints
• 4 new Inbound endpoints
• 2 new Email endpoints
• 5 new Webhook endpoints
• Added email.received and email.failed webhook event types
• 3 new contact-segment methods
• Added 5 new contact properties endpoints

Changed

• renamed Audiences -> Segments
• renamed Email.Attachment -> Email.CreateAttachment
• renamed ContactData -> CreateContactOptions
• Contact methods no longer require an audience_id

  let contact = CreateContactOptions::new("steve.wozniak@gmail.com")
      .with_first_name("Steve")
      .with_last_name("Wozniak")
  +   .with_audience_id(&audience_id);
      .with_unsubscribed(false);
  -let _contact_id = resend.contacts.create(&audience_id, contact).await?;
  +let _contact_id = resend.contacts.create(contact).await?;

• Contact get_*, update_* and delete_* methods have been merged into get, update and
  delete

0.18.0 - 2025-09-16

This is unfortunately going to break all endpoint::list calls due to backend changes. The good news is that you can get more or less the old behavior by adding:

+use resend_rs::list_opts::ListOptions;

let _emails = resend
  .emails
  .list(
+    ListOptions::default()
  ).await?;

Changed

• Email.last_event is now a strongly typed EmailEvent enum instead of a string.
• Generalized types::ListEmailOpts to list_opts::ListOpts so it can be used in other endpoints
• Generalized types::ListEmailResponse to list_opts::ListResponse, same as above^
• The following endpoints now take a ListOptions argument and return ListResponse<T>
  • api_keys::list
  • audiences::list
  • broadcasts::list
  • contacts::list
  • domains::list

Removed

• ListApiKeyResponse
• ListAudienceResponse
• ListBroadcastResponse
• ListContactResponse
• ListDomainResponse

0.17.1 - 2025-09-03

Fixed

• The resend backend renamed the header used by the batch::send_with_batch_validation method

0.17.0 - 2025-09-02

Added

• Vec<CreateEmailOptions> now implements Idempotent (should've added this earlier, oops)
• Support for batch validation modes via BatchSvc::send_with_batch_validation (and SendEmailBatchResponse).
• New endpoint: emails::list

0.16.1 - 2025-08-08

Added

• Attachment::with_content_id, will replace Attachment::with_inline_content_id in the next major release.

0.16.0 - 2025-08-08

Added

• Attachment::with_inline_content_id
• Client::with_config allowing to create a Resend client with custom configuration (#28)

Changed

• Attachment fields were made private to avoid future breaking changes when new fields are added. Use the Attachment for setting the fields instead.
• Tag fields were also made private.

0.15.0 - 2025-05-09

Added

• A bunch of #[must_use] and #[inline].

Changed

• Updated ErrorKind to match https://resend.com/docs/api-reference/errors
• Changed how idempotency_keys work;

  • CreateEmailBaseOptions no longer has an idempotency_key field, rather its with_idempotency_key method returns an instance of the new Idempotent<T> struct which is then consumed by methods that support it. Because the methods that support it (send for now) now take Into<Idempotent<CreateEmailBaseOptions>> and CreateEmailBaseOptions automatically implements that, existing code should just work.

    In order for batch emails to work similarly, a new trait idempotent::IdempotentTrait was created. Importing that adds the with_idempotency_key to iterators of type CreateEmailBaseOptions. This was all done to fix the bug I mention later.

• CreateDomainOptions::with_custom_return_path now takes Into<String> so &str can also be used

Removed

• ErrorKind::InvalidToAddress
• ErrorKind::InvalidScope
• removed already deprecated contacts::get, use contacts::get_by_id or contacts::get_by_email instead

Fixed

• Sending batch emails now correctly take 1 idempotency key instead of one per email.

0.14.1 - 2025-04-29

Added

• CreateDomainOptions::with_custom_return_path

0.14.0 - 2025-04-22

Added

• contacts::get_by_id and contacts::get_by_email

Changed

• Deprecated contacts::get in favor of contacts::get_by_id and contacts::get_by_email

Removed

• Removed deprecated contacts::update function (use contacts::update_by_id/contacts::update_by_email)

0.13.0 - 2025-04-20

Added

• CreateEmailBaseOptions::with_idempotency_key

Changed

• Moved SendEmailBatchResponse from email to batch module
• Made LocatedError, DebugResult and CLIENT (all used for testing internals) private (they were accidentally public before, very unlikely they were used by anyone)

0.12.1 - 2025-03-26

Added

• broadcasts::update and UpdateBroadcastOptions, UpdateBroadcastResponse

0.12.0 - 2025-02-25

Added

• WASM support

0.11.2 - 2025-01-18

Added

• ErrorKind now implements PartialEq, Eq (#23)

0.11.1 - 2025-01-16

Added

• Contacts::update_by_id, Contacts::update_by_email

Changed

• Contacts::update has been deprecated in favor of the above methods. The ability to use emails instead of ids was just added to the Resend backend.

0.11.0 - 2025-01-13

Added

• BroadcastId::new

Changed

• Made the following methods require &str instead of their specific ID types. This was changed to make their usage a bit simpler from the user's perspective, after all, the ID types were meant to be more like hints that a string is of an id type, rather than having specific properties in the program itself. The ID types are still used in the return types for this reason and they are also all constructable in case you want to use them. All the ID types dereference to a string so &IdType is equivalent to a &str (you might need to make this change if you were using any ID types directly before).
  • ApiKeys::delete
  • Audiences::delete
  • Broadcasts::get,delete
  • Domains::delete
• SendBroadcastOptions::new is no longer const

0.10.0 - 2024-12-13

Added

• broadcasts module
• CreateEmailBaseOptions::with_reply_multiple

Changed

• Made CreateEmailBaseOptions.reply_to field private
• The following changes were made to ensure IDs are consumed upon deletion to avoid accidetally reusing them. Of course it is still possible to clone them if necessary.
  • api_keys::delete now takes ApiKeyId instead of &str
  • audiences::delete now takes AudienceId instead of &str
  • domains::delete now takes DomainId instead of &str

0.9.2 - 2024-11-29

Added

• Added webhook support with the events module

0.9.1 - 2024-08-13

Changed

• renamed CreateEmailBaseOptions::with_scheduled to with_scheduled_at
• renamed emails::cancel_schedule to cancel

0.9.0 - 2024-08-12

Yanked due to some method naming, use 0.9.1 instead.

Added

• email.scheduled_at field (and emails::with_scheduled method for setting it)
• emails::update method
• emails::cancel_schedule method

Changed

• The following structs had all their fields made private in order to prevent future breaking changes when new fields are added. Simply use the relevant builder methods instead. GitHub issue.

  • CreateEmailBaseOptions
  • ContactData
  • ContactChanges
  • CreateDomainOptions
  • DomainChanges
  • UpdateEmailOptions

0.8.1 - 2024-07-11

Changed

• Email.text is now optional

Fixed

• The cc, bcc and text fields of the Email struct are nullable which broke deserialization. It now works as expected.

0.8.0 - 2024-07-05

Added

• rate_limit module
• Error::RateLimit

0.7.0 - 2024-07-01

Added

• Attachment::with_content_type method and content_type field
• Error::Parse variant

Changed

• HTML server responses instead of proper JSON errors (which should mostly happen in outages) now have better error messages

0.6.0 - 2024-06-16

Changed

• RATE_LIMIT to RESEND_RATE_LIMIT to avoid potential collisions with other libs

Removed

• Outdated doc comment from Client::user_agent

0.5.2 - 2024-06-10

Added

• DomainChanges::with_tls method
• docs for Domain.Tls enum options

0.5.1 - 2024-06-08

Changed

• Moved Github URLs from resend-rs to resend-rust (no code changes)

0.5.0 - 2024-06-08

Added

• DomainChanges.tls
• Rate limiting (default 9/s), configurable with RATE_LIMIT env variable (async only)

Changed

• renamed SendEmail to CreateEmailBaseOptions
• renamed email.retrieve to email.get
• renamed SendEmailResponse to CreateEmailResponse
• renamed ApiKeyData to CreateApiKeyOptions
• renamed domains.DomainData to CreateDomainOptions
• email.send now returns a CreateEmailResponse instead of an EmailId
• batch.send now returns a Vec<CreateEmailResponse> instead of a Vec<EmailId>
• audiences.create now returns CreateAudienceResponse instead of AudienceId
• contacts.update now returns UpdateContactResponse
• domains.update now returns UpdateDomainResponse
• moved batch related stuff to a new module
• email.send_batch is now batch.send
• moved error stuff from config to their own error module
• removed [...]Id types from function arguments
• implemented Deref<str> for all [...]Id types
• DomainRecord has been converted to an enum for better/more detailed type handling
• Domain.records is now optional
• Email.to is now a vec
• contacts.delete_by_email and contacts.delete_by_contact_id now return the deleted boolean
• Renamed Client to Resend
• Domain no longer has the dns_provider field.
• Domain.delete now returns a DeleteDomainResponse
• Email.Tag.value is no longer an optional
• Email.html and Email.reply_to are now both optional

Deleted

• removed ability to configure user agent via RESEND_USER_AGENT (this is no longer configuable)
• email.with_value, use the new constructor instead
• impl<T: AsRef<str>> From<T> for Tag is removed since Tag now also needs a value
• ContactChanges.email and ContactChanges.with_email

0.4.0 - 2024-05-01

@martsokha basically rewrote the entire repository 0_0 (pr)

The crate now supports the entire Resend API surface, check the docs for examples.

0.3.0 - 2024-02-06

Changed

• Mail::new now accepts a list of to addresses and thus supports sending an email to multiple recipients.

  // Before:
  let mail = Mail::new("from1", "to1", "subject1", "html1");
  
  // Now
  let mail = Mail::new("from1", &["to1"], "subject1", "html1");

0.2.0 - 2023-07-10

Disabled reqwest's default features and enabled rustls-tls.

0.1.0 - 2023-07-10

Initial release.