magedin/module-newsletter-api

The MagedIn_NewsletterApi module extends Magento 2's capabilities by providing a comprehensive API for managing newsletter subscriptions. This module allows developers to easily integrate and manage newsletter functionalities through a robust and secure API.

1.0.0 2024-07-11 15:12 UTC

This package is auto-updated.

Last update: 2024-12-11 16:09:37 UTC


README

Overview

The MagedIn_NewsletterApi module extends Magento 2's capabilities by providing a comprehensive API for managing newsletter subscriptions. This module allows developers to easily integrate and manage newsletter functionalities through a robust and secure API.

Features

  • Subscribe and unsubscribe users to newsletters
  • Retrieve subscriber information
  • Manage subscription statuses
  • Secure and easy-to-use endpoints

Installation

Prerequisites

  • Magento 2.3.x, 2.4.x
  • Composer

Usage of New API Endpoints

Using Customer Token

  • Get Self Subscription Status

    • Endpoint: GET /V1/newsletter/subscription/mine
  • Subscribe Self

    • Endpoint: POST /V1/newsletter/subscription/mine
  • Unsubscribe Self

    • Endpoint: DELETE /V1/newsletter/subscription/mine

No Token Needed

  • Guest-Subscribe by Email

    • Endpoint: POST /V1/newsletter/guest-subscription
    • Payload:
      {
        "email": "Kenna.McClure85@hotmail.com",
        "store_id": 1
      }
  • Guest Unsubscribe by Email

    • Endpoint: POST /V1/newsletter/guest-subscription/delete
    • Payload:
      {
        "email": "Kenna.McClure85@hotmail.com",
        "store_id": 1
      }

Using Admin Token

  • Get Subscription Status

    • Endpoint: GET /V1/newsletter/subscription/:customer_id
  • Subscribe

    • Endpoint: POST /V1/newsletter/subscription
    • Payload:
      {
        "customer_id": 1,
        "store_id": 1
      }
  • Unsubscribe

    • Endpoint: POST /V1/newsletter/subscription/delete
    • Payload:
      {
        "customer_id": 1,
        "store_id": 1
      }

Support

For any issues or questions, please contact our support team:

Contributing

We welcome contributions to improve this module. Please submit your pull requests to the develop branch.

Acknowledgments

Thank you for using Newsletter API for Magento 2 by MagedIn Technology. Your feedback and support are greatly appreciated.