dotmailer

A 3rd party dotMailer v2 REST API implementation

Downloads in past

Stats

StarsIssuesVersionUpdatedCreatedSize
dotmailer
4153.0.15 years ago10 years agoMinified + gzip package size for dotmailer in KB

Readme

dotMailer
build status Known Vulnerabilities
A 3rd party dotMailer v2 REST API implementation

Installation

npm install dotmailer --save

Usage

``dotMailer({endpoint, tokens, config, callback})``
  • (Required) endpoint (String) - Function name, e.g. 'PostAddressBooks'
  • (Optional) tokens (Array) - Query parameters that are passed as additional function arguments, can be String or Number, e.g. 123456
    (Required) config (Object) - Request type & options.

Example:

{
  type: 'json',
  options: {
    Name: 'Test Address Book', 
    Visibility: 'Private'
  }
}

  • (Required) callback (Function) - (error, response) Executed on completion

Tokens may be required depending on the endpoint. Required tokens that are not used will throw an error.
Some requests return 204 meaning response within the callback will be undefined if successful.

Documentation

Full documentation for the dotMailer API can be found at http://api.dotmailer.com/v2/help/wadl

Example

var config =
  { auth:
    { user: '', pass: '' }
    baseUrl: 'https://r1-api.dotmailer.com/v2/' // Account region endpoint
    // Any other 'request' options here
  }
  , dotmailer = require('dotmailer')(config)
  , addressBookId = 123456

dotmailer({
  endpoint: 'DeleteAddressBookContacts',
  tokens: [addressBookId],
  config: {
    type: 'json',
    options: {}
  }
  callback: (error, res) => {
    console.log(error, res)
  })

Tests

An integration test is provided which is not a part of ``npm test``
This test will create, update & delete an address book named 'Test Address Book'
To run:
USER=username@apiconnector.com 
PASS=pass 

$ mocha test/integration/dotmailer.integration.test.js

Credits