Skip to content

Configuring an Account

Prerequisites

The sole prerequisite for nlsMailer is an existing mailing API service account. For the library, we support two: Mailgun and MS Graph API, with others such as Gmail in the works.

Configuring Mailgun

Instructions and guides for configuring mailgun can be found at: nolongerset.com

Configuring GraphAPI

Configuring GraphAPI is a much more complex and involved process than Mailgun, so we recommend beginners utilize Mailgun. Further, due to the complex process of integrating Mailgun, treat the GraphAPI as an experimental feature.

Prerequisites

Microsoft Azure

To utilize Microsoft Graph for email functionalities, you need an active Microsoft Azure account and access to Microsoft Entra (formerly known as Azure Active Directory).

Exchange Online

Sending emails can be done using either a shared mailbox or a regular user's inbox. Ensure that you have at least one valid license that includes Exchange Online.

Registering for Graph API

To begin utilizing the Microsoft Graph API for sending emails, follow these steps:

  1. Register an Application
  2. Visit the Microsoft application registration page.
  3. Sign in to the Microsoft Entra Center.
  4. Navigate to Identity -> Applications -> App registrations and create a new application.
  5. Collect the Client ID and Tenant ID from the overview section.

  6. Generate a new client secret under Certificates & secrets, noting down its value.

  7. Configure Permissions

  8. Under API permissions, add permissions for Microsoft Graph.
  9. Select Delegated permissions and ensure that both Mail.Send and Mail.ReadWrite are enabled.