FORGEBOX Enterprise 🚀 - Take your ColdFusion (CFML) Development to Modern Times! Learn More...

Sendgrid SDK

v1.5.2 Public

sendgrid-sdk

Master Branch Build Status

An API for interacting with SendGrid, including sending emails, validating email addresses, and receiving webhooks

Email Validation

Leverage the SendGrid API to validate email addresses. SendGrid will provide a validation result, score, and test results to help you determine the validity of an email address.

Setup

Configure your SendGrid API key credentials in the config/ColdBox.cfc file.

Note: SendGrid uses a Bearer API token header for authentication with their API. The SendGrid API Keys can have different permissions granted and email address validation is typically seperate from all other permission sets.

moduleSettings = {
    "sendgrid-sdk" = {
        emailValidationAPIKey = ""
    }
};

Methods

validate

Validate the provided email address. Returns a configured HyperRequest instance.

NameTypeRequired?DefaultDescription
emailStringtrue The email address to validate
sourceStringfalse An optional text string that identifies the source of the email address

Webhooks

Easily listen to webhooks using this module. Simply point Sendgrid to https://<your-server>/sendgrid/webhooks and this module will translate all Sendgrid events to ColdBox interceptors.

The following are the interceptors that are created and the Sendgrid event they correspond with:

  • onSendgridEventProcessed => processed
  • onSendgridEventDropped => dropped
  • onSendgridEventDelivered => delivered
  • onSendgridEventDeferred => deferred
  • onSendgridEventBounce => bounce
  • onSendgridEventOpen => open
  • onSendgridEventClick => click
  • onSendgridEventSpamreport => spamreport
  • onSendgridEventUnsubscribe => unsubscribe
  • onSendgridEventGroupUnsubscribe => group_unsubscribe
  • onSendgridEventGroupResubscribe => group_resubscribe

The interceptData is the data sent from Sendgrid.

Basic Authentication

SendGrid supports basic authentication when calling your webhook. To set this up, provide a username and password in your moduleSettings:

moduleSettings = {
    "sendgrid-sdk" = {
        "username" = "foo",
        "password" = "bar"
    }
};

Note: if you only a username or a password, sendgrid-sdk will return a 500 error.

Dependencies (1)


Dev Dependencies (2)


v1.5.2

02 Aug 2022 — 01:55: 27 UTC

chore

  • box.json: Upgrade Hyper dependency (34ac270)

$ box install sendgrid-sdk

No collaborators yet.
     
  • {{ getFullDate("2017-12-05T16:03:13Z") }}
  • {{ getFullDate("2022-08-02T01:55:29Z") }}
  • 1,919
  • 2,972