mailersend-ruby 3.1.0 → 3.4.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 9b3bfbc4f6cab77294426741f5420ade91c52721573bd3885d384ccbcceb9045
-  data.tar.gz: e9c86c9b59c128fb303c7a28c39282d17b4c14f27c1503ed8495098e16387b45
+  metadata.gz: 84cfcecb512ca3be82b1060018748424960c07fb2c1f4f37b2fd0e5b495f8623
+  data.tar.gz: e2737c666d5fe36e12338faf2816dc755fbbdf8a2003eb552acc45bd19a0abe4
 SHA512:
-  metadata.gz: 24128c89d8b0206843c001f438c6258acb29a9319ffa63819c7d4390040efb9b344402442af1379dad411e16724abe3f021eb4b1029e2607a26026cfb87cd24e
-  data.tar.gz: 05652e0beb32b924ad15e2c3f251ac3b5659853172d1bdafa35c8ad4d01d0e558b4c06744285bd5a7830ff51fdc388706a5dd3013dbfd846d6471606ad90886d
+  metadata.gz: 79b0ae2b3cb61881a245ee793d13cb588838846e51488a35142755fa9cdcd7376932efe6e7b5c73c8706b3409cc1a4bca7ca4c8ceec669af72e66b00d39a7b07
+  data.tar.gz: 457825d4c739fd5be6fe2e7864bead0d3838fdbfaf26cb7675fe15be9448e6a655388791faed2c317085ccaa6b9e2e476a9de7a1a1df809cb26ff290eee82e78

data/.envrc

@@ -0,0 +1,2 @@
+use flake
+lefthook install >/dev/null

data/.github/workflows/main.yml

@@ -6,7 +6,7 @@ jobs:
   build:
     runs-on: ubuntu-latest
     steps:
-    - uses: actions/checkout@v6
+    - uses: actions/checkout@v7
 
     - name: Set up Ruby
       uses: ruby/setup-ruby@v1

data/.github/workflows/publish_gem.yml

@@ -9,7 +9,7 @@ jobs:
     runs-on: ubuntu-latest
 
     steps:
-      - uses: actions/checkout@v6
+      - uses: actions/checkout@v7
 
       - name: Set up Ruby
         uses: ruby/setup-ruby@v1

data/.gitignore

@@ -9,4 +9,5 @@
 .env
 .idea
 Gemfile.lock
-.DS_Store
+.DS_Store
+.direnv

data/CHANGELOG.md

@@ -1,5 +1,14 @@
 ## [Released]
 
+## [3.4.0] - 2026-10-26
+- WhatsApp read endpoints: messages, items, activities, inbound messages, recipients and templates (list with filters, and get by ID)
+
+## [3.3.0] - 2026-09-01
+- WhatsApp support (send template-based WhatsApp messages)
+
+## [3.2.0] - 2026-07-09
+- Add optional language field to email send
+
 ## [3.1.0] - 2026-04-24
 - DMARC Monitoring support (list, create, update, delete monitors; aggregated reports, IP-specific reports, report sources, mark/remove IP favorites)
 

data/README.md

@@ -20,6 +20,10 @@ MailerSend Ruby SDK
     - [Update a token](#update-a-token)
     - [Delete a token](#delete-a-token)
     - [Send email with attachment](#send-email-with-attachment)
+  - [Emails](#emails)
+    - [Get a list of emails](#get-a-list-of-emails)
+    - [Pagination](#pagination)
+    - [Get a single email](#get-a-single-email)
   - [Activity](#activity)
     - [Get a list of activities](#get-a-list-of-activities)
   - [Analytics](#analytics)
@@ -93,6 +97,26 @@ MailerSend Ruby SDK
     - [Create an email verification list](#create-an-email-verification-list)
     - [Verify an email list](#verify-an-email-list)
     - [Get email verification list results](#get-email-verification-list-results)
+  - [WhatsApp](#whatsapp)
+    - [Send a WhatsApp message](#send-a-whatsapp-message)
+    - [Send a WhatsApp message with personalization](#send-a-whatsapp-message-with-personalization)
+  - [WhatsApp Messages](#whatsapp-messages)
+    - [Get a list of WhatsApp messages](#get-a-list-of-whatsapp-messages)
+    - [Get a WhatsApp message](#get-a-whatsapp-message)
+  - [WhatsApp Items](#whatsapp-items)
+    - [Get a list of WhatsApp items](#get-a-list-of-whatsapp-items)
+    - [Get a WhatsApp item](#get-a-whatsapp-item)
+  - [WhatsApp Activities](#whatsapp-activities)
+    - [Get a list of WhatsApp activities](#get-a-list-of-whatsapp-activities)
+  - [WhatsApp Inbound Messages](#whatsapp-inbound-messages)
+    - [Get a list of WhatsApp inbound messages](#get-a-list-of-whatsapp-inbound-messages)
+    - [Get a WhatsApp inbound message](#get-a-whatsapp-inbound-message)
+  - [WhatsApp Recipients](#whatsapp-recipients)
+    - [Get a list of WhatsApp recipients](#get-a-list-of-whatsapp-recipients)
+    - [Get a WhatsApp recipient](#get-a-whatsapp-recipient)
+  - [WhatsApp Templates](#whatsapp-templates)
+    - [Get a list of WhatsApp templates](#get-a-list-of-whatsapp-templates)
+    - [Get a WhatsApp template](#get-a-whatsapp-template)
   - [SMS](#sms)
   - [SMS Messages](#sms-messages)
     - [Get a list of SMS messages](#get-a-list-of-sms-messages)
@@ -200,6 +224,11 @@ ms_email.add_from("email" => "april@parksandrec.com", "name" => "April")
 ms_email.add_subject("Time")
 ms_email.add_template_id(12415125)
 
+# Optional: send the template in a specific language (language code).
+# Only applies to template-based emails; ignored for raw html/text sends.
+# Supported: de, en, es, fr, it, lt, nl, pl, pt-BR
+ms_email.add_language("de")
+
 # Send the email
 ms_email.send
 ```
@@ -332,6 +361,145 @@ ms.add_attachment(content: "/Users/Jerry/Desktop/pic.png", filename: "pic.png",
 ms_email.send
 ```
 
+## Emails
+
+An email is the record of a message delivered to one recipient. Use these endpoints to build a searchable sending log,
+and to retrieve a single email together with its activity events.
+
+### Get a list of emails
+
+```ruby
+require "mailersend-ruby"
+
+ms_client = Mailersend::Client.new('your_mailersend_token')
+
+ms_emails = Mailersend::Emails.new(ms_client)
+ms_emails.list(domain_id: "xxx2241ll", date_from: 1620643567, date_to: 1623321967, page: 1, limit: 50, status: %w[sent delivered], interaction: %w[opened])
+```
+
+`domain_id`, `date_from` and `date_to` are required. Emails are returned newest first.
+
+| Keyword argument   | Type            | Required | Details                                                                                                          |
+|--------------------|-----------------|----------|------------------------------------------------------------------------------------------------------------------|
+| `domain_id`        | `String`        | yes      | A domain that belongs to your account. An unknown domain returns `404`.                                            |
+| `date_from`        | `Integer\|String` | yes    | Unix timestamp (`1620643567`) or datetime (`"2015-10-01 00:00:00"`), assumed `UTC`. Must be lower than `date_to`.   |
+| `date_to`          | `Integer\|String` | yes    | Unix timestamp or datetime. Must be higher than `date_from` and must not be in the future.                          |
+| `limit`            | `Integer`       | no       | Min: `10`, Max: `1000`, Default: `25`.                                                                            |
+| `page`             | `Integer`       | no       | Min: `1`, Max: `100`. See [Pagination](#pagination).                                                               |
+| `status`           | `Array<String>` | no       | Any of `queued`, `sent`, `rejected`, `delivered`. Sent as `status[]`.                                              |
+| `interaction`      | `Array<String>` | no       | Any of `opened`, `clicked`, `unsubscribed`, `complained`, `no_interaction`. Sent as `interaction[]`.                |
+| `recipient_email`  | `String`        | no       | Exact, case-insensitive match. An unknown address returns `200` with an empty `data` array.                         |
+| `message_id`       | `String`        | no       | Exact match.                                                                                                      |
+| `template_id`      | `String`        | no       | Exact match.                                                                                                      |
+| `subject`          | `String`        | no       | Min: `3` characters. Partial, case-insensitive match.                                                              |
+| `tag`              | `String`        | no       | Exact match against a value in the email's `tags` array.                                                           |
+
+Values inside `status` are combined with `OR`, values inside `interaction` are combined with `OR`, and the two filters
+are combined with `AND`. Pass them as arrays (`%w[sent delivered]`) — the API rejects a scalar value with `422`.
+
+> **Note:** This endpoint requires a token with one of the `activity_read` or `activity_full` scopes, and is limited to
+> 10 requests/minute shared with [`GET` /v1/activity](#get-a-list-of-activities). Requests to either endpoint count
+> against the same budget.
+
+Each row in `data` describes one email. `text` and `html` are always `null` in list rows — retrieve the content with
+[`single`](#get-a-single-email):
+
+```json
+{
+  "data": [
+    {
+      "id": "5ee0b166b251345e407c9201",
+      "from": "no-reply@your-domain.com",
+      "to": "recipient@example.com",
+      "subject": "Your order has shipped",
+      "text": null,
+      "html": null,
+      "template_id": null,
+      "domain_id": "xxx2241ll",
+      "message_id": "5ee0b174ac2b8a35e407c9210",
+      "status": "delivered",
+      "tags": ["orders"],
+      "interaction": ["opened"],
+      "suppression_reason": null,
+      "created_at": "2021-05-10T10:06:14.482000Z",
+      "updated_at": "2021-05-10T10:06:18.114000Z",
+      "headers": [{ "name": "X-Custom", "value": "foo" }]
+    }
+  ],
+  "links": {
+    "first": "https://api.mailersend.com/v1/emails?page=1",
+    "last": null,
+    "prev": null,
+    "next": "https://api.mailersend.com/v1/emails?page=2"
+  },
+  "meta": {
+    "current_page": 1,
+    "current_page_url": "https://api.mailersend.com/v1/emails?page=1",
+    "from": 1,
+    "path": "https://api.mailersend.com/v1/emails",
+    "per_page": 10,
+    "to": 3
+  }
+}
+```
+
+### Pagination
+
+`Mailersend::Emails#list` paginates by page number, the same way as
+[`Mailersend::Activity#get`](#get-a-list-of-activities). Pass `page:` to request a page, and read `meta.current_page`
+to see which page you received.
+
+The response carries no `total` and no `last_page`, and `links.last` is always `null`, so the number of pages is not
+known up front. Walk the result set by requesting the next page until `links.next` is `null`:
+
+```ruby
+require "mailersend-ruby"
+require "json"
+
+ms_client = Mailersend::Client.new('your_mailersend_token')
+ms_emails = Mailersend::Emails.new(ms_client)
+
+page = 1
+
+loop do
+  response = ms_emails.list(domain_id: "xxx2241ll", date_from: 1620643567, date_to: 1623321967, limit: 100, page: page)
+  parsed_response = JSON.parse(response.body)
+
+  parsed_response['data'].each do |email|
+    puts email['id']
+  end
+
+  break if parsed_response['links']['next'].nil?
+
+  page += 1
+end
+```
+
+Pass the same required parameters and filters on every page — changing them mid-walk restarts the result set. `page`
+accepts values from `1` to `100` and `limit` from `10` to `1000`; a value outside those ranges returns `422`. To
+retrieve a longer history, split it into several `date_from`/`date_to` windows instead of paging deeper.
+
+### Get a single email
+
+```ruby
+require "mailersend-ruby"
+
+ms_client = Mailersend::Client.new('your_mailersend_token')
+
+ms_emails = Mailersend::Emails.new(ms_client)
+ms_emails.single(email_id: "5ee0b166b251345e407c9201")
+```
+
+Pass an `id` returned by [`list`](#get-a-list-of-emails). The response contains everything a list row carries — plus
+the `text` and `html` content, the `recipient` object, and an `activity` array of the events recorded for the email.
+`template_id` is `null` when the email was not sent from a template.
+
+> **Note:** `activity` events are returned newest first and capped at 200 per email — use
+> [`Mailersend::Activity#get`](#get-a-list-of-activities) if you need the complete event history for a domain.
+> `deferred` and `suppressed` events are only included if your plan has those features enabled, and `suppressed` events
+> also carry a `suppression_reason`. The `junk` event type is reported as `soft_bounced`. The array is returned even when
+> content tracking is disabled for the domain, in which case `html` and `text` are `null`.
+
 ## Activity
 
 ### Get a list of activities
@@ -1412,6 +1580,261 @@ ms_sms_webhooks = Mailersend::SMSWebhooks.new(ms_client)
 ms_sms_webhooks.delete_sms_webhook_route(sms_webhook_id: 'your-sms-webhook-id')
 ```
 
+## WhatsApp
+
+### Send a WhatsApp message
+
+```ruby
+require "mailersend-ruby"
+
+ms_client = Mailersend::Client.new('your_mailersend_token')
+
+# Initialize the WhatsApp class
+ms_whatsapp = Mailersend::WhatsApp.new(ms_client)
+
+ms_whatsapp.add_from('your-number')
+ms_whatsapp.add_to('recipient-number')
+ms_whatsapp.add_template_id('your-template-id')
+
+ms_whatsapp.send
+```
+
+### Send a WhatsApp message with personalization
+
+```ruby
+require "mailersend-ruby"
+
+ms_client = Mailersend::Client.new('your_mailersend_token')
+
+# Initialize the WhatsApp class
+ms_whatsapp = Mailersend::WhatsApp.new(ms_client)
+
+ms_whatsapp.add_from('your-number')
+ms_whatsapp.add_to('recipient-number')
+ms_whatsapp.add_template_id('your-template-id')
+
+personalization = {
+  to: 'recipient-number',
+  data: {
+    header: ['John'],
+    body: ['order #1234', 'tomorrow'],
+    buttons: ['orders/1234']
+  }
+}
+ms_whatsapp.add_personalization(personalization)
+
+ms_whatsapp.send
+```
+
+## WhatsApp Messages
+
+### Get a list of WhatsApp messages
+
+```ruby
+require "mailersend-ruby"
+
+ms_client = Mailersend::Client.new('your_mailersend_token')
+
+# Intialize the WhatsApp Messages class
+ms_whatsapp_messages = Mailersend::WhatsAppMessages.new(ms_client)
+
+# Add parameters
+ms_whatsapp_messages.list(
+  whatsapp_account_id: 'your-whatsapp-account-id',
+  from: '15550001234',
+  template_id: 'your-template-id',
+  date_from: 1791936000,
+  date_to: 1792022400,
+  page: 1,
+  limit: 25
+)
+```
+
+### Get a WhatsApp message
+
+```ruby
+require "mailersend-ruby"
+
+ms_client = Mailersend::Client.new('your_mailersend_token')
+
+# Intialize the WhatsApp Messages class
+ms_whatsapp_messages = Mailersend::WhatsAppMessages.new(ms_client)
+
+# Add parameters
+ms_whatsapp_messages.get(whatsapp_message_id: 'your-whatsapp-message-id')
+```
+
+## WhatsApp Items
+
+### Get a list of WhatsApp items
+
+```ruby
+require "mailersend-ruby"
+
+ms_client = Mailersend::Client.new('your_mailersend_token')
+
+# Intialize the WhatsApp Items class
+ms_whatsapp_items = Mailersend::WhatsAppItems.new(ms_client)
+
+# Add parameters
+ms_whatsapp_items.list(
+  recipient: '48600000002',
+  whatsapp_message_id: 'your-whatsapp-message-id',
+  status: %w[delivered read],
+  whatsapp_account_id: 'your-whatsapp-account-id',
+  from: '15550001234',
+  template_id: 'your-template-id',
+  date_from: 1791936000,
+  date_to: 1792022400,
+  page: 1,
+  limit: 25
+)
+```
+
+### Get a WhatsApp item
+
+```ruby
+require "mailersend-ruby"
+
+ms_client = Mailersend::Client.new('your_mailersend_token')
+
+# Intialize the WhatsApp Items class
+ms_whatsapp_items = Mailersend::WhatsAppItems.new(ms_client)
+
+# Add parameters
+ms_whatsapp_items.get(whatsapp_item_id: 'your-whatsapp-item-id')
+```
+
+## WhatsApp Activities
+
+### Get a list of WhatsApp activities
+
+```ruby
+require "mailersend-ruby"
+
+ms_client = Mailersend::Client.new('your_mailersend_token')
+
+# Intialize the WhatsApp Activities class
+ms_whatsapp_activities = Mailersend::WhatsAppActivities.new(ms_client)
+
+# Add parameters
+ms_whatsapp_activities.list(
+  whatsapp_item_id: 'your-whatsapp-item-id',
+  whatsapp_message_id: 'your-whatsapp-message-id',
+  recipient: '48600000001',
+  type: %w[delivered read],
+  date_from: 1791936000,
+  date_to: 1792022400,
+  page: 1,
+  limit: 25
+)
+```
+
+## WhatsApp Inbound Messages
+
+### Get a list of WhatsApp inbound messages
+
+```ruby
+require "mailersend-ruby"
+
+ms_client = Mailersend::Client.new('your_mailersend_token')
+
+# Intialize the WhatsApp Inbound Messages class
+ms_whatsapp_inbound_messages = Mailersend::WhatsAppInboundMessages.new(ms_client)
+
+# Add parameters
+ms_whatsapp_inbound_messages.list(
+  whatsapp_account_id: 'your-whatsapp-account-id',
+  from: '48600000001',
+  type: %w[text image],
+  date_from: 1791936000,
+  date_to: 1792022400,
+  page: 1,
+  limit: 25
+)
+```
+
+### Get a WhatsApp inbound message
+
+```ruby
+require "mailersend-ruby"
+
+ms_client = Mailersend::Client.new('your_mailersend_token')
+
+# Intialize the WhatsApp Inbound Messages class
+ms_whatsapp_inbound_messages = Mailersend::WhatsAppInboundMessages.new(ms_client)
+
+# Add parameters
+ms_whatsapp_inbound_messages.get(whatsapp_inbound_message_id: 'your-whatsapp-inbound-message-id')
+```
+
+## WhatsApp Recipients
+
+### Get a list of WhatsApp recipients
+
+```ruby
+require "mailersend-ruby"
+
+ms_client = Mailersend::Client.new('your_mailersend_token')
+
+# Intialize the WhatsApp Recipient class
+ms_whatsapp_recipient = Mailersend::WhatsAppRecipient.new(ms_client)
+
+# Add parameters
+ms_whatsapp_recipient.list(status: 'active', phone_number: '48600000001', page: 1, limit: 25)
+```
+
+### Get a WhatsApp recipient
+
+```ruby
+require "mailersend-ruby"
+
+ms_client = Mailersend::Client.new('your_mailersend_token')
+
+# Intialize the WhatsApp Recipient class
+ms_whatsapp_recipient = Mailersend::WhatsAppRecipient.new(ms_client)
+
+# Add parameters
+ms_whatsapp_recipient.get(whatsapp_recipient_id: 'your-whatsapp-recipient-id')
+```
+
+## WhatsApp Templates
+
+### Get a list of WhatsApp templates
+
+```ruby
+require "mailersend-ruby"
+
+ms_client = Mailersend::Client.new('your_mailersend_token')
+
+# Intialize the WhatsApp Templates class
+ms_whatsapp_templates = Mailersend::WhatsAppTemplates.new(ms_client)
+
+# Add parameters
+ms_whatsapp_templates.list(
+  whatsapp_account_id: 'your-whatsapp-account-id',
+  status: 'approved',
+  category: 'UTILITY',
+  language: 'en_US',
+  page: 1,
+  limit: 25
+)
+```
+
+### Get a WhatsApp template
+
+```ruby
+require "mailersend-ruby"
+
+ms_client = Mailersend::Client.new('your_mailersend_token')
+
+# Intialize the WhatsApp Templates class
+ms_whatsapp_templates = Mailersend::WhatsAppTemplates.new(ms_client)
+
+# Add parameters
+ms_whatsapp_templates.get(whatsapp_template_id: 'your-whatsapp-template-id')
+```
+
 ## Other endpoints
 
 ### Get API quota

data/fixtures/email/email_send_template_language.yml

@@ -0,0 +1,56 @@
+---
+http_interactions:
+- request:
+    method: post
+    uri: https://api.mailersend.com/v1/email
+    body:
+      encoding: UTF-8
+      string: '{"from":{"email":"sender@test-sdk.com","name":"Sender"},"to":[{"email":"test@mailerlite.com","name":"Test"}],"subject":"Test
+        Email","template_id":"123abc","language":"de"}'
+    headers:
+      Authorization:
+      - "<AUTH>"
+      User-Agent:
+      - MailerSend-client-ruby/2.0.3
+      Accept:
+      - application/json
+      Connection:
+      - close
+      Content-Type:
+      - application/json; charset=utf-8
+      Host:
+      - api.mailersend.com
+  response:
+    status:
+      code: 202
+      message: Accepted
+    headers:
+      Date:
+      - Tue, 17 Dec 2024 14:04:19 GMT
+      Content-Type:
+      - text/html; charset=UTF-8
+      Transfer-Encoding:
+      - chunked
+      Connection:
+      - close
+      X-Message-Id:
+      - 676184e34aed90153c5efa6f
+      Cache-Control:
+      - no-cache, private
+      X-Apiquota-Remaining:
+      - "-1"
+      X-Apiquota-Reset:
+      - '2024-12-18T00:00:00Z'
+      Strict-Transport-Security:
+      - max-age=31536000; includeSubDomains
+      Cf-Cache-Status:
+      - DYNAMIC
+      Server:
+      - cloudflare
+      Cf-Ray:
+      - 8f37762bbd275b9a-VIE
+    body:
+      encoding: UTF-8
+      string: ''
+  recorded_at: Tue, 17 Dec 2024 14:04:19 GMT
+recorded_with: VCR 6.3.1

data/fixtures/emails/emails_list_emails.yml

@@ -0,0 +1,35 @@
+---
+http_interactions:
+- request:
+    method: get
+    uri: https://api.mailersend.com/v1/emails?date_from=1756252800&date_to=1756339200&domain_id=jpzkmgq7e5vl059v&limit=10&page=1
+    body:
+      encoding: ASCII-8BIT
+      string: ''
+    headers:
+      Authorization:
+      - "<AUTH>"
+      User-Agent:
+      - MailerSend-client-ruby/3.2.0
+      Accept:
+      - application/json
+      Connection:
+      - close
+      Host:
+      - api.mailersend.com
+  response:
+    status:
+      code: 200
+      message: OK
+    headers:
+      Content-Type:
+      - application/json
+      Cache-Control:
+      - no-cache, private
+      X-Apiquota-Remaining:
+      - "-1"
+    body:
+      encoding: UTF-8
+      string: '{"data":[{"id":"6a8fa9b1902fab56e0ce50dd","from":"sender@example.com","to":"rcpt@example.org","subject":"Welcome","text":null,"html":null,"template_id":"7nxe3yjmeq28vp0k","domain_id":"7nxe3yjmeq28vp0k","message_id":"6a8fa9b1902fab56e0ce50aa","status":"sent","tags":["newsletter"],"interaction":["opened"],"suppression_reason":null,"created_at":"2026-08-27T16:48:42.000000Z","updated_at":"2026-08-27T16:48:42.000000Z","headers":[{"name":"X-Custom","value":"foo"}]}],"links":{"first":"https://api.mailersend.com/v1/emails?page=1","last":null,"prev":null,"next":null},"meta":{"current_page":1,"current_page_url":"https://api.mailersend.com/v1/emails?page=1","from":1,"path":"https://api.mailersend.com/v1/emails","per_page":10,"to":3}}'
+  recorded_at: Thu, 27 Aug 2026 16:48:42 GMT
+recorded_with: VCR 6.3.1

data/fixtures/emails/emails_list_emails_empty_page.yml

@@ -0,0 +1,35 @@
+---
+http_interactions:
+- request:
+    method: get
+    uri: https://api.mailersend.com/v1/emails?date_from=1756252800&date_to=1756339200&domain_id=jpzkmgq7e5vl059v&limit=10&page=2
+    body:
+      encoding: ASCII-8BIT
+      string: ''
+    headers:
+      Authorization:
+      - "<AUTH>"
+      User-Agent:
+      - MailerSend-client-ruby/3.2.0
+      Accept:
+      - application/json
+      Connection:
+      - close
+      Host:
+      - api.mailersend.com
+  response:
+    status:
+      code: 200
+      message: OK
+    headers:
+      Content-Type:
+      - application/json
+      Cache-Control:
+      - no-cache, private
+      X-Apiquota-Remaining:
+      - "-1"
+    body:
+      encoding: UTF-8
+      string: '{"data":[],"links":{"first":"https://api.mailersend.com/v1/emails?page=1","last":null,"prev":"https://api.mailersend.com/v1/emails?page=1","next":null},"meta":{"current_page":2,"current_page_url":"https://api.mailersend.com/v1/emails?page=2","from":null,"path":"https://api.mailersend.com/v1/emails","per_page":10,"to":null}}'
+  recorded_at: Thu, 27 Aug 2026 16:48:42 GMT
+recorded_with: VCR 6.3.1

data/fixtures/emails/emails_single_email.yml

@@ -0,0 +1,35 @@
+---
+http_interactions:
+- request:
+    method: get
+    uri: https://api.mailersend.com/v1/email/6a8fa9b1902fab56e0ce50dd
+    body:
+      encoding: ASCII-8BIT
+      string: ''
+    headers:
+      Authorization:
+      - "<AUTH>"
+      User-Agent:
+      - MailerSend-client-ruby/3.2.0
+      Accept:
+      - application/json
+      Connection:
+      - close
+      Host:
+      - api.mailersend.com
+  response:
+    status:
+      code: 200
+      message: OK
+    headers:
+      Content-Type:
+      - application/json
+      Cache-Control:
+      - no-cache, private
+      X-Apiquota-Remaining:
+      - "-1"
+    body:
+      encoding: UTF-8
+      string: '{"data":{"id":"6a8fa9b1902fab56e0ce50dd","from":"sender@example.com","to":"rcpt@example.org","subject":"Welcome","text":"Welcome aboard.","html":"<p>Welcome aboard.</p>","template_id":"7nxe3yjmeq28vp0k","domain_id":"7nxe3yjmeq28vp0k","message_id":"6a8fa9b1902fab56e0ce50aa","status":"sent","tags":["newsletter"],"interaction":["opened"],"suppression_reason":null,"created_at":"2026-08-27T16:48:42.000000Z","updated_at":"2026-08-27T16:48:42.000000Z","headers":[{"name":"X-Custom","value":"foo"}],"recipient":{"id":"6a8fa9b1902fab56e0ce50ee","email":"rcpt@example.org","created_at":"2026-08-27T16:48:42.000000Z","updated_at":"2026-08-27T16:48:42.000000Z","deleted_at":null},"activity":[{"id":"6a8fa9b1902fab56e0ce50f3","type":"opened","created_at":"2026-08-27T16:48:57.000000Z"},{"id":"6a8fa9b1902fab56e0ce50f2","type":"delivered","created_at":"2026-08-27T16:48:47.000000Z"},{"id":"6a8fa9b1902fab56e0ce50f1","type":"sent","created_at":"2026-08-27T16:48:42.000000Z"}]}}'
+  recorded_at: Thu, 27 Aug 2026 16:48:42 GMT
+recorded_with: VCR 6.3.1