SwiftResend is a Swift package used to communicate with the Resend email sending platform API for Server Side Swift Apps.
Add the dependency to your Package.swift:
dependencies: [
...
.package(url: "https://github.com/hsharghi/swift-resend.git", from: "1.0.0")
],
targets: [
.target(name: "App", dependencies: [
.product(name: "Resend", package: "swift-resend"),
]),Configure the HTTP client and the Resend client:
let httpClient = HTTPClient(...)
let resendClient = ResendClient(httpClient: httpClient, apiKey: "YOUR_API_KEY")You can send a single email by creating a ResendEmail object and retrieving the email ID in return.
import Resend
let email: ResendEmail = .init(
from: .init(email: "hadi@example.com", name: "Hadi"),
to: ["hadi@domain.com"],
subject: "running xctest",
replyTo: [
"hadi@example.com",
"manager@example.com"
],
text: "sending email from XCTest suit",
headers: [
.init(name: "X-Entity-Ref-ID", value: "234H3-44"),
.init(name: "X-Entity-Dep-ID", value: "SALE-03"),
],
attachments: [
.init(content: .init(data: .init(contentsOf: .init(filePath: "path/to/a/file"))), filename: "sales.xlsx")
],
tags: [
.init(name: "priority", value: "medium"),
.init(name: "department", value: "sales")
]
)
let id = try await resendClient.emails.send(email)ResendEmail supports both text and html content.
You can send multiple emails at once by creating a ResendBatchEmail object.
Attachments and Tags are not supported for batch sending.
An array of email IDs will be returned.
let emails = ResendBatchEmail(...)
let ids = try await resendClient.emails.sendBatch(emails)You can retrieve information about a sent email by providing the email ID.
let emailInfo = try await resendClient.emails.get(emailId: id)Access the AudienceClient for managing audiences via the API. Refer to the Resend Audience API for complete details.
let audience = try await resendClient.audiences.create(name: "marketing")Access the ContactClient for managing contacts via the API. Refer to the Resend Contact API for complete details.
let contactId = try await resendClient.contacts.create(audienceId: audience.id,
email: "john@apple.com",
firstName: "John",
subscriptionStatus: true)If a request to the API fails for any reason, a ResendError is thrown. Ensure you catch errors like any other throwing function.
do {
try await resendClient.emails.send(...)
}
catch let error as ResendError {
print(error.message)
print(error.suggestion)
}- Emails
- Audiences
- Contacts
- Domains
- API Keys