sendpost-js

send_post_api

sendpost - JavaScript client for send_post_api Email API and SMTP relay to not just send and measure email sending, but also alert and optimise. We provide you with tools, expertise and support needed to reliably deliver emails to your customers inboxes on time, every time.

Installation

For Node.js

npm

To publish the library as a npm, please follow the procedure in "Publishing npm packages".

Then install it via:

npm install sendpost-js --save

For browser

The library also works in the browser environment via npm and browserify. After following the above steps with Node.js and installing browserify with npm install -g browserify, perform the following (assuming main.js is your entry file):

browserify main.js > bundle.js

Then include bundle.js in the HTML pages.

Webpack Configuration

Using Webpack you may encounter the following error: "Module not found: Error: Cannot resolve module", most certainly you should disable AMD loader. Add/merge the following section to your webpack config:

module: {
  rules: [
    {
      parser: {
        amd: false
      }
    }
  ]
}

Getting Started

Please follow the installation instruction and execute the following JS code:

const { EmailApi, EmailMessage } = require('sendpost-js');
const email = new EmailApi();
const apiKey = 'your_api_key'; // {String} Sub-Account API Key

(async function() {
  const message = new EmailMessage();
  message.from = { email: '[e-mail]' };
  message.to = [{ email: '[e-mail]' }]
  message.subject = 'Hello'
  message.htmlBody = '<strong>it works!</strong>';
  message.ippool = 'PiedPiper'

  const opts = {
    emailMessage: message
  };
  try {
    const data = await email.sendEmail(apiKey, opts)
    console.log('API called successfully. Returned data: ', data);
  } catch (error) {
    console.error(error);
  }
})()

Documentation for API Endpoints

All URIs are relative to https://api.sendpost.io/api/v1

Class	Method	HTTP request	Description
sendpost.EmailApi	sendEmail	POST /subaccount/email/
sendpost.EmailApi	sendEmailWithTemplate	POST /subaccount/email/template

Documentation for Models

• sendpost.Attachment
• sendpost.City
• sendpost.CopyTo
• sendpost.Device
• sendpost.EmailMessage
• sendpost.EmailResponse
• sendpost.EventMetadata
• sendpost.From
• sendpost.Os
• sendpost.QEmailMessage
• sendpost.QEvent
• sendpost.ReplyTo
• sendpost.To
• sendpost.UserAgent
• sendpost.WebhookEvent

Documentation for Authorization

Endpoints do not require authorization.