mailgun.js 12.2.0 → 12.3.1

package/README.md

@@ -27,7 +27,7 @@ __Table of Contents__
   - [Release Process](#release-process)
 
 # Documentation
-[Mailgun API Documentation](https://documentation.mailgun.com/en/latest/api_reference.html):
+[Mailgun API Documentation](https://documentation.mailgun.com/docs/mailgun/api-reference/api-overview)
 
 ## Install
 
@@ -35,7 +35,7 @@ __Table of Contents__
 
 Install mailgun.js with:
 
-```sh
+```SH
 npm install mailgun.js
 ```
 
@@ -45,7 +45,7 @@ The next step is to import the module and instantiate a mailgun client by callin
 
 NOTE: starting from version 3.0 you need to pass FormData (we need this to keep library universal). For node.js you can use built-in FormData or `form-data` library.
 
-**IMPORTANT**: if you are using EU infrastructure, you need to also pass `url: 'https://api.eu.mailgun.net'` together with auth credentials as stated in [Mailgun docs](https://documentation.mailgun.com/en/latest/quickstart-sending.html#send-via-api)
+**IMPORTANT**: if you use EU infrastructure, you need to also pass `url: 'https://api.eu.mailgun.net'` together with auth credentials as stated in [Mailgun docs](https://documentation.mailgun.com/docs/mailgun/api-reference/api-overview#base-url)
 
 ### Imports
 Once the package is installed, you can import the library using `import` or `require` approach:
@@ -186,7 +186,7 @@ Example:
 
 
 ### SubAccounts Usage
-Primary accounts can make API calls on behalf of their subaccounts. [API documentation](https://documentation.mailgun.com/en/latest/subaccounts.html#subaccounts)
+Primary accounts can make API calls on behalf of their subaccounts. [API documentation](https://documentation.mailgun.com/docs/mailgun/api-reference/send/mailgun/subaccounts)
 ```js
   import Mailgun from 'mailgun.js';
   const mailgun = new Mailgun(FormData); // or import FormData from 'form-data'
@@ -210,6 +210,10 @@ The following service methods are available to instantiated clients. The example
   - [Methods](#methods)
     - [messages](#messages)
       - [create](#create)
+      - [retrieveStoredEmail](#retrievestoredemail)
+      - [resendEmail](#resendemail)
+      - [getMessagesQueueStatus](#getmessagesqueuestatus)
+      - [clearMessagesQueue](#clearmessagesqueue)
     - [domains](#domains)
       - [list](#list)
       - [get](#get)
@@ -243,6 +247,15 @@ The following service methods are available to instantiated clients. The example
       - [get](#get-2)
       - [generate](#generate)
       - [regenerate](#regenerate)
+    - [domain keys](#domain-keys)
+      - [list](#list-2)
+      - [listAll](#listall)
+      - [create](#create-3)
+      - [activate](#activate)
+      - [deactivate](#deactivate)
+      - [destroy](#destroy-2)
+      - [updateDKIMAuthority](#updatedkimauthority-1)
+      - [updateDKIMSelector](#updatedkimselector-1)
     - [events](#events)
       - [get](#get-3)
         - [Example with Date and *Filter field*](#example-with-date-and-filter-field)
@@ -254,7 +267,7 @@ The following service methods are available to instantiated clients. The example
       - [getAccount](#getaccount-1)
       - [getAccountUsage](#getaccountusage)
     - [suppressions](#suppressions)
-      - [list](#list-2)
+      - [list](#list-3)
         - [Bounces Example](#bounces-example)
         - [Unsubscribes Example](#unsubscribes-example)
         - [Complaints Example](#complaints-example)
@@ -262,41 +275,41 @@ The following service methods are available to instantiated clients. The example
         - [Bounces Example](#bounces-example-1)
         - [Unsubscribes Example](#unsubscribes-example-1)
         - [Complaints Example](#complaints-example-1)
-      - [create](#create-3)
+      - [create](#create-4)
         - [Bounces Example](#bounces-example-2)
         - [Unsubscribes Example](#unsubscribes-example-2)
           - [Unsubscribe from one tag](#unsubscribe-from-one-tag)
           - [Unsubscribe from particular tags](#unsubscribe-from-particular-tags)
         - [Complaints Example](#complaints-example-2)
-      - [destroy](#destroy-2)
+      - [destroy](#destroy-3)
         - [Bounces Example](#bounces-example-3)
         - [Unsubscribes Example](#unsubscribes-example-3)
         - [Complaints Example](#complaints-example-3)
     - [webhooks](#webhooks)
-      - [list](#list-3)
+      - [list](#list-4)
       - [get](#get-5)
-      - [create](#create-4)
+      - [create](#create-5)
       - [update](#update-2)
-      - [destroy](#destroy-3)
+      - [destroy](#destroy-4)
     - [routes](#routes)
-      - [list](#list-4)
+      - [list](#list-5)
       - [get](#get-6)
-      - [create](#create-5)
+      - [create](#create-6)
       - [update](#update-3)
-      - [destroy](#destroy-4)
+      - [destroy](#destroy-5)
     - [validate](#validate)
       - [get](#get-7)
     - [multiple validation](#multiple-validation)
-      - [create](#create-6)
-      - [list](#list-5)
+      - [create](#create-7)
+      - [list](#list-6)
       - [get](#get-8)
-      - [destroy](#destroy-5)
+      - [destroy](#destroy-6)
     - [mailing lists](#mailing-lists)
-      - [list](#list-6)
+      - [list](#list-7)
       - [get](#get-9)
-      - [create](#create-7)
+      - [create](#create-8)
       - [update](#update-4)
-      - [destroy](#destroy-6)
+      - [destroy](#destroy-7)
     - [mailing list members](#mailing-list-members)
       - [listMembers](#listmember)
       - [getMember](#getmember)
@@ -305,39 +318,39 @@ The following service methods are available to instantiated clients. The example
       - [updateMember](#updatemember)
       - [destroyMember](#destroymember)
     - [subaccounts](#subaccounts)
-      - [list](#list-7)
+      - [list](#list-8)
       - [get](#get-10)
-      - [create](#create-8)
+      - [create](#create-9)
       - [enable](#enable)
       - [disable](#disable)
-      - [destroy](#destroy-7)
+      - [destroy](#destroy-8)
       - [setMonthlySendingLimit](#setmonthlysendinglimit)
       - [getMonthlySendingLimit](#getmonthlysendinglimit)
       - [updateSubaccountFeature](#updatesubaccountfeature)
     - [inbox placements](#inbox-placements)
       - [SeedsLists](#seedslists)
-        - [list](#list-8)
+        - [list](#list-9)
         - [get](#get-11)
-        - [create](#create-9)
+        - [create](#create-10)
         - [update](#update-5)
-        - [destroy](#destroy-8)
+        - [destroy](#destroy-9)
         - [SeedsLists Attributes](#attributes)
-          - [list](#list-9)
+          - [list](#list-10)
           - [get](#get-12)
         - [SeedsLists Filters](#filters)
-          - [list](#list-10)
+          - [list](#list-11)
       - [Providers](#providers)
-        - [list](#list-11)
-      - [Results](#results)
         - [list](#list-12)
+      - [Results](#results)
+        - [list](#list-13)
         - [get](#get-13)
-        - [destroy](#destroy-9)
+        - [destroy](#destroy-10)
         - [getResultByShareId](#getresultbyshareid)
         - [Results Attributes](#attributes-1)
-          - [list](#list-13)
+          - [list](#list-14)
           - [get](#get-14)
         - [Results Filters](#filters-1)
-          - [list](#list-14)
+          - [list](#list-15)
         - [Sharing](#sharing)
           - [get](#get-15)
           - [update](#update-6)
@@ -361,8 +374,9 @@ The following service methods are available to instantiated clients. The example
 ### Messages
 
 - #### create
+   [API Reference](https://documentation.mailgun.com/docs/mailgun/api-reference/send/mailgun/messages/post-v3--domain-name--messages)
 
-  `mg.messages.create(domain, data)` - [api docs](https://documentation.mailgun.com/en/latest/api-sending.html)
+  `mg.messages.create(domain, data)`
 
   Options:
 
@@ -501,7 +515,6 @@ The following service methods are available to instantiated clients. The example
         })
         .then(response => console.log(response))
       ```
-
     - Browser example of send file
 
       Before sending the file you need to somehow get the Blob of the file.
@@ -540,23 +553,170 @@ The following service methods are available to instantiated clients. The example
   }
   ```
 
+- #### retrieveStoredEmail
+    [API Reference](https://documentation.mailgun.com/docs/mailgun/api-reference/send/mailgun/messages/get-v3-domains--domain-name--messages--storage-key-)
+
+    `mg.messages.retrieveStoredEmail(domain, storageKey)`
+
+    **storageKey** - Storage key from the email's associated events (Example: Accepted/Delivered events storage.key field). Mentioned events can be found on https://app.mailgun.com/ (Send -> logs).
+
+    *Note: Storage keys are available for the duration of your domain's message retention policy.*
+
+    Example:
+
+    ```JS
+    mg.messages.retrieveStoredEmail('sandbox-123.mailgun.org', 'BABEAAeEDgPUyeFqr-tATLaCfYqyqvLpbg')
+      .then(storedEmail => console.log(storedEmail)) // logs response data
+      .catch(err => console.error(err)); // logs any error
+    ```
+
+    Promise returns:
+
+    ```JS
+    {
+        'Content-Type': 'multipart/alternative; boundary="boundary_12345"',
+        From: 'postmaster@sandbox.mailgun.org',
+        'Message-Id': '<123.123@sandbox.mailgun.org>',
+        'Mime-Version': '1.0',
+        Subject: 'Hello',
+        To: 'foo@example.com',
+        'X-Mailgun-Deliver-By': 'Fri, 28 Nov 2025 18:02:00 +0000',
+        sender: 'postmaster@sandbox.mailgun.org',
+        recipients: 'foo@example.com',
+        from: 'postmaster@sandbox.mailgun.org',
+        subject: 'Hello',
+        'body-html': '<a href="https://test.com">Test</a>',
+        'body-plain': 'Testing some Mailgun awesomness!',
+        attachments: [],
+        'content-id-map': {},
+        'message-headers': [
+          ['Mime-Version', '1.0'],
+          [
+            'Content-Type',
+            'multipart/alternative; boundary="boundary_12345'
+          ],
+          ['Subject', 'Hello'],
+          ['From', 'postmaster@sandbox.mailgun.org'],
+          ['To', 'foo@example.com'],
+          ['X-Mailgun-Deliver-By', 'Fri, 28 Nov 2025 18:02:00 +0000'],
+          [
+            'Message-Id',
+            '<123.123@sandbox.mailgun.org>'
+          ]
+        ],
+        'stripped-html': '<a href="https://test.com">Test</a>',
+        'stripped-text': 'Testing some Mailgun awesomness!',
+        'stripped-signature': ''
+      }
+    ```
+
+- ### resendEmail
+  [API Reference](https://documentation.mailgun.com/docs/mailgun/api-reference/send/mailgun/messages/post-v3-domains--domain-name--messages--storage-key-)
+
+  `mg.messages.resendEmail(domain, storageKey, recipient)`
+
+  **storageKey** - Storage key from the email's associated events (Example: Accepted/Delivered events storage.key field). Mentioned events can be found on https://app.mailgun.com/ (Send -> logs).
+
+  *Note: Storage keys are available for the duration of your domain's message retention policy.*
+
+  **recipient** - Email address of the recipient(s). Supports friendly name format.
+  Example: "Bob <bob@host.com>". Use commas to separate multiple recipients. Duplicate addresses are automatically ignored.
+
+  Example:
+
+  ```JS
+    mg.messages.resendEmail(
+      'sandbox-123.mailgun.org',
+      'BABEAAeEDgPUyeFqr-tATLaCfYqyqvLpbg',
+      'foo@test.com, bar@test.com'
+    ).then(resendStatus => console.log(resendStatus)) // logs response data
+    .catch(err => console.error(err)); // logs any error
+  ```
+
+  Promise returns:
+
+  ```JS
+    {
+      id: '<20151025002517.117282.79817@sandbox-123.mailgun.org>',
+      message: 'Queued. Thank you.'
+    }
+  ```
+
+- ### getMessagesQueueStatus
+  [API Reference](https://documentation.mailgun.com/docs/mailgun/api-reference/send/mailgun/messages/get-v3-domains--name--sending-queues)
+
+  `mg.messages.getMessagesQueueStatus(domain)`
+
+  Example:
+
+  ```JS
+    mg.messages.getMessagesQueueStatus('sandbox-123.mailgun.org')
+      .then(queueStatus => console.log(queueStatus)) // logs response data
+      .catch(err => console.error(err)); // logs any error
+  ```
+
+  Promise returns:
+
+  ```JS
+    {
+      regular: {
+        is_disabled: false,
+        disabled: {
+          until: null,
+          reason: ''
+        }
+      },
+      scheduled: {
+        is_disabled: true,
+        disabled: {
+          until: new Date('2025-11-28T18:02:00Z'),
+          reason: 'High load'
+        }
+      }
+    }
+  ```
+
+- ### clearMessagesQueue
+  Deletes all scheduled and undelivered mail from the domain queue.
+
+  [API Reference](https://documentation.mailgun.com/docs/mailgun/api-reference/send/mailgun/messages/delete-v3--domain-name--envelopes)
+
+  `mg.messages.getMessagesQueueStatus(domain, storageUrl)`
+
+  **storageUrl** - Mail's generated storage URL. e.g. https://storage-us-east4.api.mailgun.net/v3/example.com/envelopes. Can be found on https://app.mailgun.com/ (Send -> logs -> event). Allowed values: `storage-us-east4.api.mailgun.net`, `storage-us-west1.api.mailgun.net`, and `storage-europe-west1.api.mailgun.net`.
+
+  Example:
+
+  ```JS
+    mg.messages.clearMessagesQueue('sandbox-123.mailgun.org', 'storage-us-east4.api.mailgun.net')
+      .then(result => console.log(result)) // logs response data
+      .catch(err => console.error(err)); // logs any error
+  ```
+
+  Promise returns:
+  ```JS
+  {
+    message: "done"
+  }
+  ```
+
 ### Templates
 
   Mailgun’s templates uses a fork of the very popular template engine [handlebars](https://handlebarsjs.com/).
 
-  To provide values for a substitution you need to use 'h:X-Mailgun-Variables' property in the message description.
+  To provide values for a substitution you need to use `h:X-Mailgun-Variables` property in the message description.
 
   Make sure that this property is a JSON string like:
-  ```js
-  JSON.stringify({
-    "title": "A title",
-    "body": "The body"
-  })
+  ```JS
+    JSON.stringify({
+      title: "A title",
+      body: "The body"
+    })
   ```
 
   You can find few examples of how to use templates below.
 - Providing values for **title** and **slug** variables to render in template
-  ```js
+  ```JS
     ...
     const {
       title,
@@ -607,7 +767,7 @@ The following service methods are available to instantiated clients. The example
 
 ### Recipient Variables
 
-  [Docs](https://documentation.mailgun.com/en/latest/user_manual.html#batch-sending)
+  [API Reference](https://documentation.mailgun.com/docs/mailgun/api-reference/send/mailgun/messages/post-v3--domain-name--messages)
 
   Recipient Variables are custom variables that you define, which you can then reference in the message body. They give you the ability to send a custom message to each recipient while still using a single API Call.
 
@@ -640,14 +800,17 @@ The following service methods are available to instantiated clients. The example
 
 - #### list
   Get the list of domains. Can be filtered by state or authority. Sorting is optional. The list is paginated and limited to 1000 items per page.
-  `mg.domains.list(query)` - [api docs](https://documentation.mailgun.com/docs/mailgun/api-reference/openapi-final/tag/Domains/#tag/Domains/operation/GET-v4-domains)
+
+  [API Reference](https://documentation.mailgun.com/docs/mailgun/api-reference/send/mailgun/domains/get-v4-domains)
+
+  `mg.domains.list(query)`
 
   Example:
 
-  ```js
-  mg.domains.list()
-    .then(domains => console.log(domains)) // logs array of domains
-    .catch(err => console.error(err)); // logs any error
+  ```JS
+    mg.domains.list()
+      .then(domains => console.log(domains)) // logs array of domains
+      .catch(err => console.error(err)); // logs any error
   ```
 
   Promise returns: array of Domain instances
@@ -688,7 +851,9 @@ The following service methods are available to instantiated clients. The example
 - #### get
   Fetches representation of a domain that includes details about the domain's state and settings.
 
-  `mg.domains.get(domain, query)`  - [api docs](https://documentation.mailgun.com/docs/mailgun/api-reference/openapi-final/tag/Domains/#tag/Domains/operation/GET-v4-domains--name-)
+  [API Reference](https://documentation.mailgun.com/docs/mailgun/api-reference/send/mailgun/domains/get-v4-domains--name-)
+
+  `mg.domains.get(domain, query)`
 
   Example:
 
@@ -756,7 +921,9 @@ The following service methods are available to instantiated clients. The example
 - #### create
   Creates a domain for sending emails
 
-  `mg.domains.create(data)` [api docs](https://documentation.mailgun.com/docs/mailgun/api-reference/openapi-final/tag/Domains/#tag/Domains/operation/POST-v4-domains)
+  [API Reference](https://documentation.mailgun.com/docs/mailgun/api-reference/send/mailgun/domains/post-v4-domains)
+
+  `mg.domains.create(data)`
 
   Example:
 
@@ -848,7 +1015,9 @@ The following service methods are available to instantiated clients. The example
 - #### verify
   Verify the domains DNS records (includes A, CNAME, SPF, DKIM and MX records) to ensure the domain is ready and able to send
 
-  `mg.domains.verify(domainAddress)` [api docs](https://documentation.mailgun.com/docs/mailgun/api-reference/openapi-final/tag/Domains/#tag/Domains/operation/PUT-v4-domains--name--verify)
+  [API Reference](https://documentation.mailgun.com/docs/mailgun/api-reference/send/mailgun/domains/put-v4-domains--name--verify)
+
+  `mg.domains.verify(domainAddress)`
 
   Example:
 
@@ -906,7 +1075,9 @@ The following service methods are available to instantiated clients. The example
 - #### update
   Update domains configuration like smtp credentials, enable/disable automatic sender security, spam actions, wildcard, or tracking web scheme.
 
-  `mg.domains.update(domain, options)` [api docs](https://documentation.mailgun.com/docs/mailgun/api-reference/openapi-final/tag/Domains/#tag/Domains/operation/PUT-v4-domains--name-)
+  [API Reference](https://documentation.mailgun.com/docs/mailgun/api-reference/send/mailgun/domains/put-v4-domains--name-)
+
+  `mg.domains.update(domain, options)`
 
   Example:
 
@@ -986,7 +1157,10 @@ The following service methods are available to instantiated clients. The example
 
 - #### destroy
   The domain must not be disabled or used as an authority for an other domain. Sandbox domain can't be deleted.
-  `mg.domains.destroy(domainAddress)` [api docs](https://documentation.mailgun.com/docs/mailgun/api-reference/openapi-final/tag/Domains/#tag/Domains/operation/DELETE-v3-domains--name-)
+
+  [API Reference](https://documentation.mailgun.com/docs/mailgun/api-reference/send/mailgun/domains/delete-v3-domains--name-)
+
+  `mg.domains.destroy(domainAddress)`
 
   Example:
 
@@ -1011,9 +1185,13 @@ The following service methods are available to instantiated clients. The example
    `domains.updateTracking` method is deprecated, and will be removed. Please use `domains.domainTracking.updateTracking` instead.
 
 - #### getConnection
+  ***Deprecated, and will be removed in the future releases***
+
   Returns domain's delivery connection settings.
 
-  `mg.domains.getConnection(domainAddress)` [api docs](https://documentation.mailgun.com/docs/mailgun/api-reference/openapi-final/tag/Domain-Connection/#tag/Domain-Connection/operation/GET-v3-domains--name--connection)
+  [API Reference](https://mailgun-docs.redoc.ly/docs/mailgun/api-reference/domain/operation/httpapi.(*T).GetDomainConnection-fm-14-0/)
+
+  `mg.domains.getConnection(domainAddress)`
 
   Example:
 
@@ -1033,9 +1211,13 @@ The following service methods are available to instantiated clients. The example
   ```
 
 - #### updateConnection
+  ***Deprecated, and will be removed in the future releases***
+
   Update a domain's TLS connection settings.
 
-  `mg.domains.updateConnection(domainAddress, data)` [api docs](https://documentation.mailgun.com/docs/mailgun/api-reference/openapi-final/tag/Domain-Connection/#tag/Domain-Connection/operation/PUT-v3-domains--name--connection)
+  [API Reference](https://mailgun-docs.redoc.ly/docs/mailgun/api-reference/domain/operation/httpapi.(*T).UpdateDomainConnection-fm-15-0/)
+
+  `mg.domains.updateConnection(domainAddress, data)`
 
   Example:
 
@@ -1059,78 +1241,13 @@ The following service methods are available to instantiated clients. The example
   ```
 
 - #### updateDKIMAuthority
-  You can delegate the domain authority to an other domain. Domain's authority is set to itself by default.
-
-  `mg.domains.updateDKIMAuthority(domainAddress, data)` [api docs](https://documentation.mailgun.com/docs/mailgun/api-reference/openapi-final/tag/Domain-Keys/#tag/Domain-Keys/operation/PUT-v3-domains--name--dkim-authority)
-
-  Example:
-
-  ```JS
-  mg.domains.updateDKIMAuthority(domainAddress, {
-    self: true
-  })
-    .then(data => console.log(data)) // logs response data
-    .catch(err => console.error(err)); // logs any error
-  ```
-
-  Data object accepts next properties:
-
-  | Property    | Description                                                                                                                                   |
-  |:--------------|:----------------------------------------------------------------------------------------------------------------------------------------------|
-  | self | Change the DKIM authority for a domain. If set to true, the domain will be the DKIM authority for itself even if the root domain is registered on the same mailgun account If set to false, the domain will have the same DKIM authority as the root domain registered on the same mailgun account |
-
-  Promise returns:
-
-  ```JS
-  {
-  message: 'Domain DKIM authority has been changed',
-  sending_dns_records: [
-    {
-      is_active: true,
-      cached: [],
-      name: 'sending_dns_record_name',
-      record_type: 'TXT',
-      valid: 'unknown',
-      value: 'sending_dns_record_value'
-    },
-    ...
-  ],
-  changed: true
-  }
-  ```
+  `domains.updateDKIMAuthority` method is deprecated, and will be removed. Please use `domains.domainKeys.updateDKIMAuthority` [instead](#updatedkimauthority-1).
 
 - #### updateDKIMSelector
-  Selector is the unique identifier of your key. It has to be different from other keys selector.
-
-  `mg.domains.updateDKIMSelector(domainAddress, data)` [api docs](https://documentation.mailgun.com/docs/mailgun/api-reference/openapi-final/tag/Domain-Keys/#tag/Domain-Keys/operation/PUT-v3-domains--name--dkim-selector)
-
-  Example:
-
-  ```JS
-  mg.domains.updateDKIMSelector(domainAddress, {
-    dkimSelector: 'dkimSelector_value'
-  })
-    .then(data => console.log(data)) // logs response data
-    .catch(err => console.error(err)); // logs any error
-  ```
-
-  Data object accepts next properties:
-
-  | Property    | Description                                                                                                                                   |
-  |:--------------|:----------------------------------------------------------------------------------------------------------------------------------------------|
-  | dkimSelector | Selector is the unique identifier of your key. It has to be different from other keys selector. |
-
-  Promise returns:
-
-  ```JS
-  {
-    message: 'DKIM selector changed',
-    status: 200
-  }
-  ```
+  `domains.updateDKIMSelector` method is deprecated, and will be removed. Please use `domains.domainKeys.updateDKIMSelector` [instead](#updatedkimselector-1).
 
 - #### getIps
-    **Deprecated, and will be removed in the future releases**
+    ***Deprecated, and will be removed in the future releases***
 
     `mg.domains.getIps(domain)`
 
@@ -1149,7 +1266,7 @@ The following service methods are available to instantiated clients. The example
     ```
 
 - #### assignIp
-   **Deprecated, and will be removed in the future releases**
+   ***Deprecated, and will be removed in the future releases***
   `mg.domains.assignIp(domain, ip)`
 
   Example:
@@ -1191,7 +1308,9 @@ The following service methods are available to instantiated clients. The example
 - #### list
   Returns a list of templates for the domain.
 
-  `mg.domains.domainTemplates.list('domainId', query)` - [api docs](https://documentation.mailgun.com/docs/mailgun/api-reference/openapi-final/tag/Templates/#tag/Templates/operation/httpapi.(*TemplateAPIControler).GetPage-fm-9)
+  [API Reference](https://documentation.mailgun.com/docs/mailgun/api-reference/send/mailgun/templates/get-v3--domain-name--templates)
+
+  `mg.domains.domainTemplates.list('domainId', query)`
 
   Example:
 
@@ -1230,7 +1349,9 @@ The following service methods are available to instantiated clients. The example
 
   Returns metadata information about the stored template specified in the url. If the active flag is provided, the content of the active version of the template is returned.
 
-  `mg.domains.domainTemplates.get('domainId', 'templateName', query)`  [api docs](https://documentation.mailgun.com/docs/mailgun/api-reference/openapi-final/tag/Templates/#tag/Templates/operation/httpapi.(*TemplateAPIControler).Get-fm-6)
+  [API Reference](https://documentation.mailgun.com/docs/mailgun/api-reference/send/mailgun/templates/get-v3--domain-name--templates--template-name-)
+
+  `mg.domains.domainTemplates.get('domainId', 'templateName', query)`
 
   Example:
 
@@ -1275,7 +1396,9 @@ The following service methods are available to instantiated clients. The example
   Store a new template, including its name, description and (optionally) the template content.
   If the template content is provided, a new version is automatically created and becomes the active version.
 
-  `mg.domains.domainTemplates.create(domainId, templateData)` [api docs](https://documentation.mailgun.com/docs/mailgun/api-reference/openapi-final/tag/Templates/#tag/Templates/operation/httpapi.(*TemplateAPIControler).Post-fm-4)
+  [API Reference](https://documentation.mailgun.com/docs/mailgun/api-reference/send/mailgun/templates/post-v3--domain-name--templates)
+
+  `mg.domains.domainTemplates.create(domainId, templateData)`
 
   Example:
 
@@ -1334,7 +1457,9 @@ The following service methods are available to instantiated clients. The example
 - #### update
   Update the description of a template.
 
-  `mg.domains.domainTemplates.update('domainId', 'templateName', data)` [api docs](https://documentation.mailgun.com/docs/mailgun/api-reference/openapi-final/tag/Templates/#tag/Templates/operation/httpapi.(*TemplateAPIControler).Put-fm-12)
+  [API Reference](https://documentation.mailgun.com/docs/mailgun/api-reference/send/mailgun/templates/put-v3--domain-name--templates--template-name-)
+
+  `mg.domains.domainTemplates.update('domainId', 'templateName', data)`
 
   Example:
 
@@ -1363,7 +1488,9 @@ The following service methods are available to instantiated clients. The example
 - #### destroy
   Delete the template specified in the url. NOTE: This method deletes all versions of the specified template.
 
-  `mg.domains.domainTemplates.destroy('domainId', 'templateName')` [api docs](https://documentation.mailgun.com/docs/mailgun/api-reference/openapi-final/tag/Templates/#tag/Templates/operation/httpapi.(*TemplateAPIControler).Delete-fm-13)
+  [API Reference](https://documentation.mailgun.com/docs/mailgun/api-reference/send/mailgun/templates/delete-v3--domain-name--templates--template-name-)
+
+  `mg.domains.domainTemplates.destroy('domainId', 'templateName')`
 
   Example:
 
@@ -1385,7 +1512,9 @@ The following service methods are available to instantiated clients. The example
 - #### destroyAll
   Delete all templates and their versions for the domain.
 
-  `mg.domains.domainTemplates.destroyAll('domainId')` [api docs](https://documentation.mailgun.com/docs/mailgun/api-reference/openapi-final/tag/Templates/#tag/Templates/operation/httpapi.(*TemplateAPIControler).DeleteAll-fm-15)
+  [API Reference](https://documentation.mailgun.com/docs/mailgun/api-reference/send/mailgun/templates/delete-v3--domain-name--templates)
+
+  `mg.domains.domainTemplates.destroyAll('domainId')`
 
   Example:
 
@@ -1406,7 +1535,9 @@ The following service methods are available to instantiated clients. The example
 - #### listVersions
   Returns a paginated list of template versions.
 
-  `mg.domains.domainTemplates.listVersions('domainId', 'template_name', queryData)` [api docs](https://documentation.mailgun.com/docs/mailgun/api-reference/openapi-final/tag/Templates/#tag/Templates/operation/httpapi.(*TemplateAPIControler).GetVersionsPage-fm-8)
+  [API Reference](https://documentation.mailgun.com/docs/mailgun/api-reference/send/mailgun/templates/get-v3--domain-name--templates--template-name--versions)
+
+  `mg.domains.domainTemplates.listVersions('domainId', 'template_name', queryData)`
 
   Example:
 
@@ -1453,7 +1584,9 @@ The following service methods are available to instantiated clients. The example
 
   Retrieve the information and content of the specified version of a template.
 
-  `mg.domains.domainTemplates.getVersion('domainId', 'template_name', 'tag')` [api docs](https://documentation.mailgun.com/docs/mailgun/api-reference/openapi-final/tag/Templates/#tag/Templates/operation/httpapi.(*TemplateAPIControler).GetVersion-fm-7)
+  [API Reference](https://documentation.mailgun.com/docs/mailgun/api-reference/send/mailgun/templates/get-v3--domain-name--templates--template-name--versions--version-name-)
+
+  `mg.domains.domainTemplates.getVersion('domainId', 'template_name', 'tag')`
 
   Example:
 
@@ -1494,7 +1627,9 @@ The following service methods are available to instantiated clients. The example
 - #### createVersion
   Adds a new template version. If the template doesn’t contain any other versions, the first version becomes active. A template can store up to 40 versions.
 
-  `mg.domains.domainTemplates.createVersion('domainId', 'template_name', versionData)` [api docs](https://documentation.mailgun.com/docs/mailgun/api-reference/openapi-final/tag/Templates/#tag/Templates/operation/httpapi.(*TemplateAPIControler).PostVersion-fm-5)
+  [API Reference](https://documentation.mailgun.com/docs/mailgun/api-reference/send/mailgun/templates/post-v3--domain-name--templates--template-name--versions)
+
+  `mg.domains.domainTemplates.createVersion('domainId', 'template_name', versionData)`
 
   Example:
 
@@ -1556,7 +1691,9 @@ The following service methods are available to instantiated clients. The example
   Update information or content of the specific template version.
   Existing fields not included in the request will not be changed
 
-  `mg.domains.domainTemplates.updateVersion('domainId', 'template_name', 'tag' , versionData)` [api docs](https://documentation.mailgun.com/docs/mailgun/api-reference/openapi-final/tag/Templates/#tag/Templates/operation/httpapi.(*TemplateAPIControler).PutVersion-fm-11)
+  [API Reference](https://documentation.mailgun.com/docs/mailgun/api-reference/send/mailgun/templates/put-v3--domain-name--templates--template-name--versions--version-name-)
+
+  `mg.domains.domainTemplates.updateVersion('domainId', 'template_name', 'tag' , versionData)`
 
   Example:
 
@@ -1601,7 +1738,9 @@ The following service methods are available to instantiated clients. The example
 - #### destroyVersion
   Delete a specific template version.
 
-  `mg.domains.domainTemplates.destroyVersion('domainId', 'template_name', 'tag' )` [api docs](https://documentation.mailgun.com/docs/mailgun/api-reference/openapi-final/tag/Templates/#tag/Templates/operation/httpapi.(*TemplateAPIControler).DeleteVersion-fm-14)
+  [API Reference](https://documentation.mailgun.com/docs/mailgun/api-reference/send/mailgun/templates/delete-v3--domain-name--templates--template-name--versions--version-name-)
+
+  `mg.domains.domainTemplates.destroyVersion(domainId, templateName, tag)`
 
   Example:
 
@@ -1616,7 +1755,9 @@ The following service methods are available to instantiated clients. The example
       status: 200,
       message: 'version has been deleted',
       templateName: 'template_name',
-      templateVersion: { tag: 'v1' }
+      templateVersion: {
+        tag:'v1'
+      }
     }
     ```
 
@@ -1626,7 +1767,9 @@ The following service methods are available to instantiated clients. The example
 
   Mailgun offers tracking for clicks, unsubscribes, and opens, with optional HTTPS protocol support on tracking URLs. To enable HTTPS, Mailgun uses Let’s Encrypt with HTTP-01 challenges through your existing tracking CNAME record to issue a TLS certificate. This setup also includes support for HTTP Strict Transport Security (HSTS) for enhanced security.
 
-  `mg.domains.domainTracking.getTracking(domainAddress)` [api docs](https://documentation.mailgun.com/docs/mailgun/api-reference/openapi-final/tag/Domain-Tracking/#tag/Domain-Tracking)
+  [API Reference](https://documentation.mailgun.com/docs/mailgun/api-reference/send/mailgun/domain-tracking/get-v3-domains--name--tracking)
+
+  `mg.domains.domainTracking.getTracking(domainAddress)`
 
   Example:
 
@@ -1662,7 +1805,8 @@ The following service methods are available to instantiated clients. The example
 
   - Open Tracking Example:
 
-    [api docs](https://documentation.mailgun.com/docs/mailgun/api-reference/openapi-final/tag/Domain-Tracking/#tag/Domain-Tracking/operation/PUT-v3-domains--name--tracking-open)
+    [API Reference](https://documentation.mailgun.com/docs/mailgun/api-reference/send/mailgun/domain-tracking/put-v3-domains--name--tracking-open)
+
     ```js
     mg.domains.domainTracking.updateTracking('foobar.example.com', 'open', {
       active: true,
@@ -1693,7 +1837,7 @@ The following service methods are available to instantiated clients. The example
 
   - Click Tracking Example:
 
-    [api docs](https://documentation.mailgun.com/docs/mailgun/api-reference/openapi-final/tag/Domain-Tracking/#tag/Domain-Tracking/operation/PUT-v3-domains--name--tracking-click)
+    [API Reference](https://documentation.mailgun.com/docs/mailgun/api-reference/send/mailgun/domain-tracking/put-v3-domains--name--tracking-click)
     ```JS
     mg.domains.domainTracking.updateTracking('foobar.example.com', 'click', {active: true})
       .then(msg => console.log(msg)) // logs response data
@@ -1719,7 +1863,7 @@ The following service methods are available to instantiated clients. The example
 
   - Unsubscribe Tracking Example
 
-    [api docs](https://documentation.mailgun.com/docs/mailgun/api-reference/openapi-final/tag/Domain-Tracking/#tag/Domain-Tracking/operation/PUT-v3-domains--name--tracking-unsubscribe)
+    [API Reference](https://documentation.mailgun.com/docs/mailgun/api-reference/send/mailgun/domain-tracking/put-v3-domains--name--tracking-unsubscribe)
     ```js
     mg.domains.domainTracking.updateTracking('foobar.example.com', 'unsubscribe', {
         active: true,
@@ -1754,7 +1898,9 @@ The following service methods are available to instantiated clients. The example
 - #### get
   Get x509 TLS certificate and status
 
-  `mg.domains.domainTracking.get(domainAddress)` [api docs](https://documentation.mailgun.com/docs/mailgun/api-reference/openapi-final/tag/Domain-Tracking/#tag/Domain-Tracking/operation/httpapi.(*HttpAPI).getStatusV2-fm-8)
+  [API Reference](https://documentation.mailgun.com/docs/mailgun/api-reference/send/mailgun/domain-tracking/get-v2-x509--domain--status)
+
+  `mg.domains.domainTracking.get(domainAddress)`
 
   Example:
 
@@ -1778,7 +1924,9 @@ The following service methods are available to instantiated clients. The example
 - #### generate
   Initiates generation of a TLS certificate for the tracking domain in a background task. Once generation is enqueued, you may poll the status endpoint in location field to check for success. Domain address must be formatted as `webPrefix.domainName` from domains settings
 
-  `mg.domains.domainTracking.generate(domainAddress)` [api docs](https://documentation.mailgun.com/docs/mailgun/api-reference/openapi-final/tag/Domain-Tracking/#tag/Domain-Tracking/operation/httpapi.(*HttpAPI).generateStatusV2-fm-8)
+  [API Reference](https://documentation.mailgun.com/docs/mailgun/api-reference/send/mailgun/domain-tracking/post-v2-x509--domain-)
+
+  `mg.domains.domainTracking.generate(domainAddress)`
 
   Example:
 
@@ -1801,7 +1949,9 @@ The following service methods are available to instantiated clients. The example
 - #### regenerate
   Initiates regeneration of an expired TLS certificate for the tracking domain in a background task. Once generation is enqueued, you may poll status endpoint in location field to check for success. This will not regenerate an existing certificate that is still valid. Domain address must be formatted as `webPrefix.domainName` from domains settings
 
-  `mg.domains.domainTracking.regenerate(domainAddress)` [api docs](https://documentation.mailgun.com/docs/mailgun/api-reference/openapi-final/tag/Domain-Tracking/#tag/Domain-Tracking/operation/httpapi.(*HttpAPI).generateStatusV2-fm-8)
+  [API Reference](https://documentation.mailgun.com/docs/mailgun/api-reference/send/mailgun/domain-tracking/put-v2-x509--domain-)
+
+  `mg.domains.domainTracking.regenerate(domainAddress)`
 
   Example:
 
@@ -1821,9 +1971,290 @@ The following service methods are available to instantiated clients. The example
   }
   ```
 
+### Domain Keys
+
+- #### list
+  List all domain keys for your domain, including active/inactive and valid/invalid ones.
+
+  `mg.domains.domainKeys.list(domainAddress, data)`
+
+  [API Reference](https://documentation.mailgun.com/docs/mailgun/api-reference/send/mailgun/domain-keys/get-v4-domains--authority-name--keys)
+
+  Example:
+
+  ```JS
+    mg.domains.domainKeys.list(domainAddress)
+      .then(data => console.log(data)) // logs response data
+      .catch(err => console.error(err)); // logs any error
+  ```
+
+  Promise returns:
+
+  ```JS
+  {
+    items: [
+      {
+        signing_domain: 'authority.domain.tld',
+        selector: 's1',
+        dns_record: {
+          is_active: true,
+          cached: [],
+          name: 's1._domainkey.authority.domain.tld',
+          record_type: 'TXT',
+          valid: 'unknown',
+          value: 'expected dns value'
+        }
+      },
+    ],
+    status: 200
+  }
+  ```
+
+- #### listAll
+  List domain keys, and optionally filter by signing domain or selector. The page & limit data is only required when paging through the data.
+
+  `mg.domains.domainKeys.listAll(filterData)`
+
+  [API Reference](https://documentation.mailgun.com/docs/mailgun/api-reference/send/mailgun/domain-keys/get-v1-dkim-keys)
+
+   Example:
+
+  ```JS
+    mg.domains.domainKeys.listAll(
+      {
+        signingDomain: 'authority.domain.tld', // optional
+        selector: 's1', // optional
+      }
+    )
+    .then(data => console.log(data)) // logs response data
+    .catch(err => console.error(err)); // logs any error
+  ```
+
+  Promise returns:
+
+  ```JS
+  {
+    items: [
+      {
+        signing_domain: 'authority.domain.tld',
+        selector: 's1',
+        dns_record: {
+          is_active: true,
+          cached: [],
+          name: 's1._domainkey.authority.domain.tld',
+          record_type: 'TXT',
+          valid: 'unknown',
+          value: 'expected dns value'
+        }
+      },
+    ],
+    status: 200
+  }
+  ```
+
+- #### create
+  Create a domain key.
+
+  *Note that once private keys are created or imported they are never exported. Alternatively, you can import an existing PEM file containing a RSA private key in PKCS #1, ASn.1 DER format. Note, the pem can be passed as a file attachment or as a form-string parameter.*
+
+  `mg.domains.domainKeys.create(newKeyData)`
+
+  [API Reference](https://documentation.mailgun.com/docs/mailgun/api-reference/send/mailgun/domain-keys/post-v1-dkim-keys)
+
+  Example:
+
+  ```JS
+    mg.domains.domainKeys.create(
+      {
+        signingDomain: 'authority.domain.tld',
+        selector: 's1',
+        bits: '2048' // optional
+      }
+    )
+    .then(data => console.log(data)) // logs response data
+    .catch(err => console.error(err)); // logs any error
+  ```
+
+  Promise returns:
+
+  ```JS
+  {
+    signing_domain: 'authority.domain.tld',
+    selector: 's1',
+    dns_record: {
+      is_active: true,
+      cached: [],
+      name: 's1._domainkey.authority.domain.tld',
+      record_type: 'TXT',
+      valid: 'unknown',
+      value: 'expected dns value'
+    },
+    status: 200
+  }
+  ```
+
+- #### activate
+  Activate a key to be used to DKIM sign emails with.
+
+  *Note: dns records must be valid for a domain key to be activated*
+
+  `mg.domains.domainKeys.activate(domainAddress, selector)`
+
+  [API Reference](https://documentation.mailgun.com/docs/mailgun/api-reference/send/mailgun/domain-keys/put-v4-domains--authority-name--keys--selector--activate)
+
+  Example:
+
+  ```JS
+    mg.domains.domainKeys.activate('authority.domain.tld', 's1')
+      .then(data => console.log(data)) // logs response data
+      .catch(err => console.error(err)); // logs any error
+  ```
+
+  Promise returns:
+
+  ```JS
+  {
+    message: 'domain key activated',
+    authority: 'authority.domain.tld',
+    selector: 's1',
+    active: true,
+    status: 200,
+  }
+  ```
+
+- #### deactivate
+  Deactivating for a specified authority and/or selector means a key won't be used for signing email anymore, even if they are valid.
+
+  `mg.domains.domainKeys.deactivate(domainAddress, selector)`
+
+  [API Reference](https://documentation.mailgun.com/docs/mailgun/api-reference/send/mailgun/domain-keys/put-v4-domains--authority-name--keys--selector--deactivate)
+
+  Example:
+
+  ```JS
+    mg.domains.domainKeys.deactivate('authority.domain.tld', 's1')
+      .then(data => console.log(data)) // logs response data
+      .catch(err => console.error(err)); // logs any error
+  ```
+
+  Promise returns:
+
+  ```JS
+  {
+    message: 'domain key deactivated',
+    authority: 'authority.domain.tld',
+    selector: 's1',
+    active: true,
+    status: 200,
+  }
+  ```
+
+- #### destroy
+  Delete a key.
+
+  **Domain keys are not recoverable after deletion so use with care**
+
+  `mg.domains.domainKeys.destroy(domainAddress, selector)`
+
+  [API Reference](https://documentation.mailgun.com/docs/mailgun/api-reference/send/mailgun/domain-keys/delete-v1-dkim-keys)
+
+  Example:
+
+  ```JS
+    mg.domains.domainKeys.destroy('authority.domain.tld', 's1')
+      .then(data => console.log(data)) // logs response data
+      .catch(err => console.error(err)); // logs any error
+  ```
+
+  Promise returns:
+
+  ```JS
+  {
+    message: 'success'
+  }
+  ```
+
+- #### updateDKIMAuthority
+  You can delegate the domain authority to an other domain. Domain's authority is set to itself by default.
+
+  [API Reference](https://documentation.mailgun.com/docs/mailgun/api-reference/send/mailgun/domain-keys/put-v3-domains--name--dkim-authority)
+
+  `mg.domains.domainKeys.updateDKIMAuthority(domainAddress, data)`
+
+  Example:
+
+  ```JS
+    mg.domains.domainKeys.updateDKIMAuthority(domainAddress, {
+      self: true
+    })
+      .then(data => console.log(data)) // logs response data
+      .catch(err => console.error(err)); // logs any error
+  ```
+
+  Data object accepts next properties:
+
+  | Property    | Description                                                                                                                                   |
+  |:--------------|:----------------------------------------------------------------------------------------------------------------------------------------------|
+  | self | Change the DKIM authority for a domain. If set to true, the domain will be the DKIM authority for itself even if the root domain is registered on the same mailgun account If set to false, the domain will have the same DKIM authority as the root domain registered on the same mailgun account |
+
+  Promise returns:
+
+  ```JS
+  {
+  message: 'Domain DKIM authority has been changed',
+  sending_dns_records: [
+    {
+      is_active: true,
+      cached: [],
+      name: 'sending_dns_record_name',
+      record_type: 'TXT',
+      valid: 'unknown',
+      value: 'sending_dns_record_value'
+    },
+    ...
+  ],
+  changed: true
+  }
+  ```
+
+- #### updateDKIMSelector
+  Selector is the unique identifier of your key. It has to be different from other keys selector.
+
+  [API Reference](https://documentation.mailgun.com/docs/mailgun/api-reference/send/mailgun/domain-keys/put-v3-domains--name--dkim-selector)
+
+  `mg.domains.domainKeys.updateDKIMSelector(domainAddress, data)`
+
+  Example:
+
+  ```JS
+  mg.domains.domainKeys.updateDKIMSelector(domainAddress, {
+    dkimSelector: 'dkimSelector_value'
+  })
+    .then(data => console.log(data)) // logs response data
+    .catch(err => console.error(err)); // logs any error
+  ```
+
+  Data object accepts next properties:
+
+  | Property    | Description                                                                                                                                   |
+  |:--------------|:----------------------------------------------------------------------------------------------------------------------------------------------|
+  | dkimSelector | Selector is the unique identifier of your key. It has to be different from other keys selector. |
+
+  Promise returns:
+
+  ```JS
+  {
+    message: 'DKIM selector changed',
+    status: 200
+  }
+  ```
+
 ### Events
 
 - #### get
+  ***Deprecated, and will be removed in the future releases***
+
+  [API Reference](https://documentation.mailgun.com/docs/mailgun/api-reference/send/mailgun/events)
 
   `mg.events.get(domain, data)`
 
@@ -1847,7 +2278,7 @@ The following service methods are available to instantiated clients. The example
   | end       | The end of the search time range. It can be specified as a string (see Date Format) or linux epoch seconds. Refer to Time Range for details.                                                                                                                                    |
   | ascending | Defines the direction of the search time range if the range end time is not specified. Can be either yes or no. Refer to Time Range for details.                                                                                                                                |
   | limit     | Number of entries to return. (300 max)                                                                                                                                                                                                                                          |
-  | **field** | **field** is the name of the *[Filter Field](https://documentation.mailgun.com/en/latest/api-events.html#filter-field)*. The value of the parameter should be a valid Filter Expression. Several field filters can be specified in one request. If the same field is mentioned, more then once, then all its filter expressions are combined with AND operator. |
+  | **field** | **field** is the name of the *[Filter Field](https://mailgun-docs.redoc.ly/docs/mailgun/user-manual/events/#filter-field)*. The value of the parameter should be a valid Filter Expression. Several field filters can be specified in one request. If the same field is mentioned, more then once, then all its filter expressions are combined with AND operator. |
   - #### Example with Date and *Filter field*
     ```js
       const date = new Date(2023, 7, 2, 0, 0, 0, 0); // Wed Aug 02 2023 00:00:00 GMT+0300
@@ -1858,6 +2289,7 @@ The following service methods are available to instantiated clients. The example
           event: 'delivered'
         });
     ```
+
   Promise returns: items (array of event objects), pages (paging keys grouped by id)
 
   ```JS
@@ -1878,8 +2310,11 @@ The following service methods are available to instantiated clients. The example
   ```
 
 ### Stats
-- #### Stats Options
+  ***Deprecated, and will be removed in the future releases***
+
+  [API Reference](https://documentation.mailgun.com/docs/mailgun/api-reference/send/mailgun/stats)
 
+- #### Stats Options
     | Parameter  | Description                                                                                                                |
     |:-----------|:---------------------------------------------------------------------------------------------------------------------------|
     | event      | The type of the event. For a complete list of all events written to the log see the `Event Types` table below. (Required)  |
@@ -1915,6 +2350,8 @@ The following service methods are available to instantiated clients. The example
 
 - #### getDomain
 
+  [API Reference](https://mailgun-docs.redoc.ly/docs/mailgun/api-reference/openapi-final/tag/Stats/#tag/Stats/operation/GET-v3--domain--stats-total)
+
   `mg.stats.getDomain(domain, query)`
 
   Example:
@@ -1940,6 +2377,7 @@ The following service methods are available to instantiated clients. The example
   ```
 
 - #### getAccount
+  [API Reference](https://mailgun-docs.redoc.ly/docs/mailgun/api-reference/openapi-final/tag/Stats/#tag/Stats/operation/GET-v3-stats-total)
 
   `mg.stats.getDomain(domain, query)`
 
@@ -1969,11 +2407,13 @@ The following service methods are available to instantiated clients. The example
   ```
 
 ### Metrics
-  Mailgun collects many different events and generates event metrics which are available in your Control Panel. This data is also available via our analytics metrics [API endpoint](https://documentation.mailgun.com/docs/mailgun/api-reference/openapi-final/tag/Metrics/#tag/Metrics).
+  Mailgun collects many different events and generates event metrics which are available in your Control Panel. This data is also available via our analytics metrics [API Reference](https://documentation.mailgun.com/docs/mailgun/api-reference/send/mailgun/metrics).
 
 - #### getAccount
   Gets filtered metrics for an account
 
+  [API Reference](https://documentation.mailgun.com/docs/mailgun/api-reference/send/mailgun/metrics/post-v1-analytics-metrics)
+
   `mg.metrics.getAccount(MetricsQuery);`
 
   Example:
@@ -2007,7 +2447,7 @@ The following service methods are available to instantiated clients. The example
   | duration   | String | A duration in the format of '1d' '2h' '2m'. If duration is provided then it is calculated from the end date and overwrites the start date.|
   | dimensions | Array of strings | Attributes of the metric data such as 'subaccount'.|
   | metrics    | Array of strings | Name of the metrics to receive the stats for such as 'processed_count'.|
-  | filter    | object | Filters to apply to the query. The 'AND' property is required and should contains array of filters objects. See this [document](https://documentation.mailgun.com/docs/mailgun/api-reference/openapi-final/tag/Metrics/#tag/Metrics/operation/api.(*MetricsAPI).PostMetricQuery-fm-3!path=filter&t=request) for an object shape. |
+  | filter    | object | Filters to apply to the query. The 'AND' property is required and should contains array of filters objects. See this [document](https://documentation.mailgun.com/docs/mailgun/api-reference/send/mailgun/metrics/post-v1-analytics-metrics#metrics/post-v1-analytics-metrics/t=request&path=filter) for an object shape. |
   | include_subaccounts | Boolean | Include stats from all subaccounts. |
   | include_aggregates  | Boolean | Include top-level aggregate metrics.|
 
@@ -2040,6 +2480,9 @@ The following service methods are available to instantiated clients. The example
 
 - #### getAccountUsage
   Gets filtered **usage metrics** for an account
+
+  [API Reference](https://documentation.mailgun.com/docs/mailgun/api-reference/send/mailgun/metrics/post-v1-analytics-usage-metrics)
+
   `mg.metrics.getAccountUsage(MetricsQuery);`
 
   Example:
@@ -2073,7 +2516,7 @@ The following service methods are available to instantiated clients. The example
   | duration   | String | A duration in the format of '1d' '2h' '2m'. If duration is provided then it is calculated from the end date and overwrites the start date.|
   | dimensions | Array of strings | Attributes of the metric data such as 'subaccount'.|
   | metrics    | Array of strings | Name of the metrics to receive the stats for such as 'processed_count'.|
-  | filter    | object | Filters to apply to the query. The 'AND' property is required and should contains array of filters objects. See this [document](https://documentation.mailgun.com/docs/mailgun/api-reference/openapi-final/tag/Metrics/#tag/Metrics/operation/api.(*MetricsAPI).PostMetricQuery-fm-3!path=filter&t=request) for an object shape. |
+  | filter    | object | Filters to apply to the query. The 'AND' property is required and should contains array of filters objects. See this [document](https://documentation.mailgun.com/docs/mailgun/api-reference/send/mailgun/metrics/post-v1-analytics-metrics#metrics/post-v1-analytics-metrics/t=request&path=filter) for an object shape. |
   | include_subaccounts | Boolean | Include stats from all subaccounts. |
   | include_aggregates  | Boolean | Include top-level aggregate metrics.|
 
@@ -2111,7 +2554,7 @@ The following service methods are available to instantiated clients. The example
   `mg.suppressions.list(domain, suppressionType, query?)`
 
   - #### Bounces Example:
-
+    [API Reference](https://documentation.mailgun.com/docs/mailgun/api-reference/send/mailgun/bounces/get-v3--domainid--bounces)
     ```js
     mg.suppressions.list('foobar.example.com', 'bounces')
       .then(msg => console.log(msg)) // logs response data
@@ -2119,7 +2562,7 @@ The following service methods are available to instantiated clients. The example
     ```
 
   - #### Unsubscribes Example:
-
+    [API Reference](https://documentation.mailgun.com/docs/mailgun/api-reference/send/mailgun/unsubscribe/get-v3--domainid--unsubscribes)
     ```js
     mg.suppressions.list('foobar.example.com', 'unsubscribes')
       .then(msg => console.log(msg)) // logs response data
@@ -2128,6 +2571,8 @@ The following service methods are available to instantiated clients. The example
 
   - #### Complaints Example:
 
+    [API Reference](https://documentation.mailgun.com/docs/mailgun/api-reference/send/mailgun/complaints/get-v3--domainid--complaints)
+
     ```js
     mg.suppressions.list('foobar.example.com', 'complaints')
       .then(msg => console.log(msg)) // logs response data
@@ -2160,7 +2605,7 @@ The following service methods are available to instantiated clients. The example
   `mg.suppressions.get(domain, suppressionType, address)`
 
   - #### Bounces Example:
-
+    [API Reference](https://documentation.mailgun.com/docs/mailgun/api-reference/send/mailgun/bounces/get-v3--domainid--bounces--address-)
     ```js
     mg.suppressions.get('foobar.example.com', 'bounces', 'address@example.com')
       .then(msg => console.log(msg)) // logs response data
@@ -2168,6 +2613,7 @@ The following service methods are available to instantiated clients. The example
     ```
 
   - #### Unsubscribes Example:
+    [API Reference](https://documentation.mailgun.com/docs/mailgun/api-reference/send/mailgun/unsubscribe/get-v3--domainid--unsubscribes--address-)
 
     ```js
     mg.suppressions.get('foobar.example.com', 'unsubscribes', 'address@example.com')
@@ -2177,6 +2623,8 @@ The following service methods are available to instantiated clients. The example
 
   - #### Complaints Example:
 
+    [API Reference](https://documentation.mailgun.com/docs/mailgun/api-reference/send/mailgun/complaints/get-v3--domainid--complaints--address-)
+
     ```js
     mg.suppressions.get('foobar.example.com', 'complaints', 'address@example.com')
       .then(msg => console.log(msg)) // logs response data
@@ -2198,6 +2646,8 @@ The following service methods are available to instantiated clients. The example
     `mg.suppressions.create(domain, suppressionType, data || data[])`
 
     - #### Bounces Example:
+      [API Reference](https://documentation.mailgun.com/docs/mailgun/api-reference/send/mailgun/bounces/post-v3--domainid--bounces)
+
       ```JS
       mg.suppressions.create('foobar.example.com', 'bounces', [{address: 'bob@example.com'}])
         .then(msg => console.log(msg)) // logs response data
@@ -2222,7 +2672,7 @@ The following service methods are available to instantiated clients. The example
       ```
 
     - #### Unsubscribes Example:
-
+      [API Reference](https://documentation.mailgun.com/docs/mailgun/api-reference/send/mailgun/unsubscribe/post-v3--domainid--unsubscribes)
       ```js
       mg.suppressions.create('foobar.example.com', 'unsubscribes', {address: 'bob@example.com'})
         .then(msg => console.log(msg)) // logs response data
@@ -2273,8 +2723,8 @@ The following service methods are available to instantiated clients. The example
           ```
 
     - #### Complaints Example:
-
-      ```js
+      [API Reference](https://documentation.mailgun.com/docs/mailgun/api-reference/send/mailgun/complaints/post-v3--domainid--complaints)
+      ```JS
       mg.suppressions.create('foobar.example.com', 'complaints', [{address: 'bob@example.com'}])
         .then(msg => console.log(msg)) // logs response data
         .catch(err => console.error(err)); // logs any error
@@ -2299,7 +2749,7 @@ The following service methods are available to instantiated clients. The example
     `mg.suppressions.destroy(domain, suppressionType, address)`
 
     - #### Bounces Example:
-
+      [API Reference](https://documentation.mailgun.com/docs/mailgun/api-reference/send/mailgun/bounces/delete-v3--domainid--bounces--address-)
       ```JS
       mg.suppressions.destroy('foobar.example.com', 'bounces', 'bob@example.com')
         .then(msg => console.log(msg)) // logs response data
@@ -2318,7 +2768,7 @@ The following service methods are available to instantiated clients. The example
       ```
 
     - #### Unsubscribes Example:
-
+      [API Reference](https://documentation.mailgun.com/docs/mailgun/api-reference/send/mailgun/unsubscribe/delete-v3--domainid--unsubscribes--address-)
       ```js
       mg.suppressions.destroy('foobar.example.com', 'unsubscribes', 'bob@example.com')
         .then(msg => console.log(msg)) // logs response data
@@ -2337,7 +2787,7 @@ The following service methods are available to instantiated clients. The example
       ```
 
     - #### Complaints Example:
-
+      [API Reference](https://documentation.mailgun.com/docs/mailgun/api-reference/send/mailgun/complaints/delete-v3--domainid--complaints--address-)
       ```js
       mg.suppressions.destroy('foobar.example.com', 'complaints', 'bob@example.com')
         .then(msg => console.log(msg)) // logs response data
@@ -2357,6 +2807,7 @@ The following service methods are available to instantiated clients. The example
 ### Webhooks
 
 - #### list
+  [API Reference](https://documentation.mailgun.com/docs/inboxready/api-reference/optimize/mailgun/webhooks/get-v3-domains--domain--webhooks)
 
   `mg.webhooks.list(domain, query)`
 
@@ -2385,6 +2836,7 @@ The following service methods are available to instantiated clients. The example
   ```
 
 - #### get
+  [API Reference](https://documentation.mailgun.com/docs/inboxready/api-reference/optimize/mailgun/webhooks/get-v3-domains--domain-name--webhooks--webhook-name-)
 
   `mg.webhooks.get(domain, id)`
 
@@ -2405,6 +2857,7 @@ The following service methods are available to instantiated clients. The example
   ```
 
 - #### create
+  [API Reference](https://documentation.mailgun.com/docs/inboxready/api-reference/optimize/mailgun/webhooks/post-v3-domains--domain--webhooks)
 
   `mg.webhooks.create(domain, id, data, test)`
 
@@ -2442,6 +2895,7 @@ The following service methods are available to instantiated clients. The example
   ```
 
 - #### update
+  [API Reference](https://documentation.mailgun.com/docs/inboxready/api-reference/optimize/mailgun/webhooks/put-v3-domains--domain-name--webhooks--webhook-name-)
 
   `mg.webhooks.update(domain, id, url, test)`
 
@@ -2476,6 +2930,7 @@ The following service methods are available to instantiated clients. The example
 
 
 - #### destroy
+  [API Reference](https://documentation.mailgun.com/docs/inboxready/api-reference/optimize/mailgun/webhooks/delete-v3-domains--domain-name--webhooks--webhook-name-)
 
   `mg.webhooks.destroy(domain, id)`
 
@@ -2498,6 +2953,7 @@ The following service methods are available to instantiated clients. The example
 ### Routes
 
 - #### list
+  [API Reference](https://documentation.mailgun.com/docs/mailgun/api-reference/send/mailgun/routes/get-v3-routes)
 
   `mg.routes.list(query)`
 
@@ -2525,6 +2981,7 @@ The following service methods are available to instantiated clients. The example
   ```
 
 - #### get
+  [API Reference](https://documentation.mailgun.com/docs/mailgun/api-reference/send/mailgun/routes/get-v3-routes-id)
 
   `mg.routes.get(id)`
 
@@ -2550,6 +3007,7 @@ The following service methods are available to instantiated clients. The example
   ```
 
 - #### create
+  [API Reference](https://documentation.mailgun.com/docs/mailgun/api-reference/send/mailgun/routes/post-v3-routes)
 
   `mg.routes.create(options)`
 
@@ -2580,6 +3038,7 @@ The following service methods are available to instantiated clients. The example
   ```
 
 - #### update
+  [API Reference](https://documentation.mailgun.com/docs/mailgun/api-reference/send/mailgun/routes/put-v3-routes-id)
 
   `mg.routes.update(id, options)`
 
@@ -2611,6 +3070,7 @@ The following service methods are available to instantiated clients. The example
   ```
 
 - #### destroy
+  [API Reference](https://documentation.mailgun.com/docs/mailgun/api-reference/send/mailgun/routes/delete-v3-routes-id)
 
   `mg.routes.destroy(id)`
 
@@ -2634,6 +3094,7 @@ The following service methods are available to instantiated clients. The example
 ### Validation
 
 - #### get
+  [API Reference](https://documentation.mailgun.com/docs/validate/single-valid-ir)
 
   `mg.validate.get(address)`
 
@@ -2661,7 +3122,8 @@ The following service methods are available to instantiated clients. The example
   ```
 
 ### Multiple validation
-https://documentation.mailgun.com/en/latest/api-email-validation.html#email-validation
+  [API Reference](https://documentation.mailgun.com/docs/validate/bulk-valid-ir)
+
 - #### create
   `mg.validate.multipleValidation.create('name_of_the_list', { file })`
 
@@ -2800,6 +3262,7 @@ https://documentation.mailgun.com/en/latest/api-email-validation.html#email-vali
   A client to manage mailing lists.
 
 - #### list
+  [API Reference](https://documentation.mailgun.com/docs/mailgun/api-reference/send/mailgun/mailing-lists/get-v3-lists)
 
   `mg.lists.list()`
 
@@ -2828,6 +3291,7 @@ https://documentation.mailgun.com/en/latest/api-email-validation.html#email-vali
   ```
 
 - #### get
+  [API Reference](https://documentation.mailgun.com/docs/mailgun/api-reference/send/mailgun/mailing-lists/get-v3-lists-address)
 
   `mg.lists.get(mailListAddress)`
 
@@ -2854,6 +3318,7 @@ https://documentation.mailgun.com/en/latest/api-email-validation.html#email-vali
   ```
 
 - #### create
+  [API Reference](https://documentation.mailgun.com/docs/mailgun/api-reference/send/mailgun/mailing-lists/post-v3-lists)
 
   `mg.lists.create(data)`
 
@@ -2886,6 +3351,7 @@ https://documentation.mailgun.com/en/latest/api-email-validation.html#email-vali
   ```
 
 - #### update
+  [API Reference](https://documentation.mailgun.com/docs/mailgun/api-reference/send/mailgun/mailing-lists/put-v3-lists-address)
 
   `mg.lists.update(mailListAddress)`
 
@@ -2918,6 +3384,7 @@ https://documentation.mailgun.com/en/latest/api-email-validation.html#email-vali
   ```
 
 - #### destroy
+  [API Reference](https://documentation.mailgun.com/docs/mailgun/api-reference/send/mailgun/mailing-lists/delete-v3-lists-address)
 
   `mg.lists.destroy(mailListAddress)`
 
@@ -2939,9 +3406,10 @@ https://documentation.mailgun.com/en/latest/api-email-validation.html#email-vali
   ```
 
 ### Mailing list members
-A client to manage members within a specific mailing list.
+  A client to manage members within a specific mailing list.
 
 - #### listMembers
+  [API Reference](https://documentation.mailgun.com/docs/mailgun/api-reference/send/mailgun/mailing-lists/get-lists-string:list_address-members)
 
   `mg.lists.members.listMembers(mailListAddress)`
 
@@ -2967,6 +3435,8 @@ A client to manage members within a specific mailing list.
   ```
 
 - #### getMember
+  [API Reference](https://documentation.mailgun.com/docs/mailgun/api-reference/send/mailgun/mailing-lists/get-lists-list_address-members-member_address)
+
   `mg.lists.members.getMember(mailListAddress, mailListMemberAddress)`
 
   Example:
@@ -2989,6 +3459,8 @@ A client to manage members within a specific mailing list.
   ```
 
 - #### createMember
+  [API Reference](https://documentation.mailgun.com/docs/mailgun/api-reference/send/mailgun/mailing-lists/post-lists-string:list_address-members)
+
   `mg.lists.members.createMember(mailListAddress, data)`
 
   Example:
@@ -3017,6 +3489,7 @@ A client to manage members within a specific mailing list.
   ```
 
 - #### createMembers
+  [API Reference](https://documentation.mailgun.com/docs/mailgun/api-reference/send/mailgun/mailing-lists/post-lists-list_address-members.json)
   `mg.lists.members.createMembers(mailListAddress, data)`
 
   Example:
@@ -3062,6 +3535,7 @@ A client to manage members within a specific mailing list.
   ```
 
 - #### updateMember
+  [API Reference](https://documentation.mailgun.com/docs/mailgun/api-reference/send/mailgun/mailing-lists/put-lists-list_address-members-member_address)
 
   `mg.lists.members.updateMember(mailListAddress, mailListMemberAddress, data)`
 
@@ -3090,6 +3564,7 @@ A client to manage members within a specific mailing list.
   ```
 
 - #### destroyMember
+  [API Reference](https://documentation.mailgun.com/docs/mailgun/api-reference/send/mailgun/mailing-lists/delete-lists-list_address-members-member_address)
 
   `mg.lists.members.destroyMember(mailListAddress, mailListMemberAddress)`
 
@@ -3109,13 +3584,15 @@ A client to manage members within a specific mailing list.
     message: 'Mailing list member has been deleted'
   }
   ```
+
 ### Subaccounts
 
   A client to manage subaccounts.
 
 - #### list
+  [API Reference](https://documentation.mailgun.com/docs/mailgun/api-reference/send/mailgun/subaccounts/get-v5-accounts-subaccounts)
 
-  `mg.subaccounts.list(query)` - [api docs](https://documentation.mailgun.com/en/latest/subaccounts.html)
+  `mg.subaccounts.list(query)`
 
   Example:
 
@@ -3144,6 +3621,7 @@ A client to manage members within a specific mailing list.
   | enabled  | Returns all enabled/disabled subaccounts. (Defaults to all if omitted) |
 
 - #### get
+  [API Reference](https://documentation.mailgun.com/docs/mailgun/api-reference/send/mailgun/subaccounts/get-v5-accounts-subaccounts-subaccount_id)
 
   `mg.subaccounts.get(subaccount_id)`
 
@@ -3162,6 +3640,7 @@ A client to manage members within a specific mailing list.
   ```
 
 - #### create
+  [API Reference](https://documentation.mailgun.com/docs/mailgun/api-reference/send/mailgun/subaccounts/post-v5-accounts-subaccounts)
 
   `mg.subaccounts.create(name)`
 
@@ -3186,6 +3665,7 @@ A client to manage members within a specific mailing list.
   | name 	     | Name of the subaccount being created (ex. 'mysubaccount') 	 |
 
 - #### enable
+  [API Reference](https://documentation.mailgun.com/docs/mailgun/api-reference/send/mailgun/subaccounts/post-v5-accounts-subaccounts-subaccount_id-enable)
 
   `mg.subaccounts.enable(subaccount_id)`
 
@@ -3203,6 +3683,7 @@ A client to manage members within a specific mailing list.
   ```
 
 - #### disable
+  [API Reference](https://documentation.mailgun.com/docs/mailgun/api-reference/send/mailgun/subaccounts/post-v5-accounts-subaccounts-subaccount_id-disable)
 
   `mg.subaccounts.disable(subaccount_id)`
 
@@ -3220,6 +3701,7 @@ A client to manage members within a specific mailing list.
   ```
 
 - #### destroy
+  [API Reference](https://documentation.mailgun.com/docs/mailgun/api-reference/send/mailgun/subaccounts/delete-v5-accounts-subaccounts-subaccount_id)
 
   `mg.subaccounts.destroy(subaccount_id)`
 
@@ -3237,8 +3719,9 @@ A client to manage members within a specific mailing list.
   ```
 
 - #### setMonthlySendingLimit
+  [API Reference](https://documentation.mailgun.com/docs/mailgun/api-reference/send/mailgun/subaccounts/put-v5-accounts-subaccounts-subaccount_id-limit-custom-monthly)
 
-   `mg.subaccounts.setMonthlySendingLimit(subaccount_id, limit)`
+  `mg.subaccounts.setMonthlySendingLimit(subaccount_id, limit)`
 
   Example:
 
@@ -3254,6 +3737,7 @@ A client to manage members within a specific mailing list.
   ```
 
 - #### getMonthlySendingLimit
+  [API Reference](https://documentation.mailgun.com/docs/mailgun/api-reference/send/mailgun/subaccounts/get-v5-accounts-subaccounts-subaccount_id-limit-custom-monthly)
 
   `mg.subaccounts.getMonthlySendingLimit(subaccount_id)`
 
@@ -3271,6 +3755,8 @@ A client to manage members within a specific mailing list.
   ```
 
 - #### updateSubaccountFeature
+  [API Reference](https://documentation.mailgun.com/docs/mailgun/api-reference/send/mailgun/subaccounts/put-v5-accounts-subaccounts-subaccount_id-features)
+
   `mg.subaccounts.updateSubaccountFeature(subaccount_id, featuresValues)`
 
   Example:
@@ -3302,9 +3788,12 @@ A client to manage members within a specific mailing list.
 
 ### Inbox Placements
   A client to allows you to see the likely deliverability of your email campaigns.
+
 - #### SeedsLists
 
   - #### list
+    [API Reference](https://documentation.mailgun.com/docs/inboxready/api-reference/optimize/inboxready/inbox-placement/get-v4-inbox-seedlists)
+
     `mg.inboxPlacements.seedsLists.list()`
 
       Example:
@@ -3398,6 +3887,8 @@ A client to manage members within a specific mailing list.
       ```
 
   - #### get
+    [API Reference](https://documentation.mailgun.com/docs/inboxready/api-reference/optimize/inboxready/inbox-placement/get-v4-inbox-seedlists--address-)
+
     `mg.inboxPlacements.seedsLists.get(seedsListId)`
 
     Example:
@@ -3480,6 +3971,8 @@ A client to manage members within a specific mailing list.
     ```
 
   - #### create
+    [API Reference](https://documentation.mailgun.com/docs/inboxready/api-reference/optimize/inboxready/inbox-placement/post-v4-inbox-seedlists)
+
     ```js
     mg.inboxPlacements.seedsLists.create({
       name: 'seedLists name',
@@ -3541,6 +4034,7 @@ A client to manage members within a specific mailing list.
     ```
 
   - #### update
+    [API Reference](https://documentation.mailgun.com/docs/inboxready/api-reference/optimize/inboxready/inbox-placement/put-v4-inbox-seedlists--address-)
 
     ```JS
     mg.inboxPlacements.seedsLists.update(seedsListId,{
@@ -3602,6 +4096,8 @@ A client to manage members within a specific mailing list.
     ```
 
   - #### destroy
+    [API Reference](https://documentation.mailgun.com/docs/inboxready/api-reference/optimize/inboxready/inbox-placement/delete-v4-inbox-seedlists--address-)
+
     ```js
     mg.inboxPlacements.seedsLists.destroy(seedsListId)
     ```
@@ -3625,6 +4121,9 @@ A client to manage members within a specific mailing list.
   - #### Attributes
 
     - #### list
+
+      [API Reference](https://documentation.mailgun.com/docs/inboxready/api-reference/optimize/inboxready/inbox-placement/get-v4-inbox-seedlists-a)
+
       `mg.inboxPlacements.seedsLists.attributes.list()`
 
       Example:
@@ -3646,7 +4145,9 @@ A client to manage members within a specific mailing list.
       ```
 
     - #### get
-      `mg.inboxPlacements.attributes.get('attribute_name');`
+      [API Reference](https://documentation.mailgun.com/docs/inboxready/api-reference/optimize/inboxready/inbox-placement/get-v4-inbox-seedlists-a--attribute-)
+
+      `mg.inboxPlacements.seedsLists.attributes.get('attribute_name');`
 
       Example:
       ```JS
@@ -3668,6 +4169,8 @@ A client to manage members within a specific mailing list.
   - #### Filters
 
     - #### list
+      [API Reference](https://documentation.mailgun.com/docs/inboxready/api-reference/optimize/inboxready/inbox-placement/get-v4-inbox-seedlists--filters)
+
       `mg.inboxPlacements.seedsLists.filters.list()`
 
       Example:
@@ -3695,6 +4198,8 @@ A client to manage members within a specific mailing list.
 - #### Providers
 
   - #### list
+    [API Reference](https://documentation.mailgun.com/docs/inboxready/api-reference/optimize/inboxready/inbox-placement/get-v4-inbox-providers)
+
     List all available email providers.
 
     `mg.inboxPlacements.providers.list()`
@@ -3725,6 +4230,8 @@ A client to manage members within a specific mailing list.
 - #### Results
 
   - #### list
+      [API Reference](https://documentation.mailgun.com/docs/inboxready/api-reference/optimize/inboxready/inbox-placement/get-v4-inbox-results)
+
       Get the details for all placement test results.
 
       ```js
@@ -3856,6 +4363,9 @@ A client to manage members within a specific mailing list.
 
     Get the details for a single result.
 
+    [API Reference](https://documentation.mailgun.com/docs/inboxready/api-reference/optimize/inboxready/inbox-placement/get-v4-inbox-results--result-)
+
+
     `mg.inboxPlacements.results.get(IBPResultId)`
 
     Example:
@@ -3958,6 +4468,8 @@ A client to manage members within a specific mailing list.
     ```
 
   - #### destroy
+    [API Reference](https://documentation.mailgun.com/docs/inboxready/api-reference/optimize/inboxready/inbox-placement/delete-v4-inbox-results--result-)
+
     Delete the result and all associated information.
 
     `mg.inboxPlacements.results.destroy(IBPResultId)`
@@ -3980,6 +4492,9 @@ A client to manage members within a specific mailing list.
 
   - #### getResultByShareId
       Get a result by the share ID.
+
+      [API Reference](https://documentation.mailgun.com/docs/inboxready/api-reference/optimize/inboxready/inbox-placement/get-v4-inbox-sharing-public--shareid-)
+
       ```js
       mg.inboxPlacements.results.getResultByShareId('result_sharing_id')
       ```
@@ -4086,6 +4601,8 @@ A client to manage members within a specific mailing list.
   - #### Attributes
 
     - #### list
+      [API Reference](https://documentation.mailgun.com/docs/inboxready/api-reference/optimize/inboxready/inbox-placement/get-v4-inbox-results-a)
+
       `mg.inboxPlacements.results.attributes.list()`
 
       Example:
@@ -4107,6 +4624,8 @@ A client to manage members within a specific mailing list.
       ```
 
     - #### get
+      [API Reference](https://documentation.mailgun.com/docs/inboxready/api-reference/optimize/inboxready/inbox-placement/get-v4-inbox-results-a--attribute-)
+
       `mg.inboxPlacements.attributes.get('attribute_name');`
 
       Example:
@@ -4129,6 +4648,8 @@ A client to manage members within a specific mailing list.
   - #### Filters
 
     - #### list
+        [API Reference](https://documentation.mailgun.com/docs/inboxready/api-reference/optimize/inboxready/inbox-placement/get-v4-inbox-results--filters)
+
         `mg.inboxPlacements.results.filters.list()`
 
         Example:
@@ -4157,6 +4678,8 @@ A client to manage members within a specific mailing list.
     - #### get
       The sharing status of a result.
 
+      [API Reference](https://documentation.mailgun.com/docs/inboxready/api-reference/optimize/inboxready/inbox-placement/get-v4-inbox-sharing--result-)
+
       `mg.inboxPlacements.results.sharing.get('result_id');`
       Example:
         ```JS
@@ -4179,6 +4702,8 @@ A client to manage members within a specific mailing list.
     - #### update
       Change the sharing status of a result or create a new share URL
 
+      [API Reference](https://documentation.mailgun.com/docs/inboxready/api-reference/optimize/inboxready/inbox-placement/put-v4-inbox-sharing--result-)
+
       `mg.inboxPlacements.results.sharing.update('result_id', IPRSharingUpdateData);`
 
       Example:
@@ -4207,6 +4732,8 @@ A client to manage members within a specific mailing list.
 
   'variables' are Template variables, which could be used in html or template. You can use next recipient variables inside Template variables, which will be filled for every seed automatically: %recipient.first_name%, %recipient.last_name%.
 
+  [API Reference](https://documentation.mailgun.com/docs/inboxready/api-reference/optimize/inboxready/inbox-placement/post-v4-inbox-tests)
+
   `mg.inboxPlacements.runTest(InboxPlacementsData);`
 
   Example: