node-marketo v1.0.0

node-marketo

A node.js library for the marketo API (further details: https://developers.marketo.com)

node-marketo exposes the following features of the marketo API to your node.js application:

Caution - some of these routes are not officially supported or listed in the api and may change

Version v3

• user-details

Installation

Installing using npm (node package manager):

npm install node-marketo

If you don't have npm installed or don't want to use it:

cd ~/.node_libraries
git clone git@github.com:Datahero/node-marketo.git

Please note that parts of node-marketo depend on request by Mikeal Rogers. This library needs to be installed for the API to work. Additionally node-querystring is required. If you are using npm all dependencies should be automagically resolved for you.

Usage

Information on how to use the marketo APIs can be found below. Further information on the API methods available can be found at https://developer.marketo.com. You can also find further information on how to obtain an API key, and/or OAuth2 in your marketo account and much more on the marketo API pages.

marketo API

marketoAPI takes an options object, The only required option for version3 of the api is an oAuth token.

http://developer.marketo.com/docs/auth/

All API requests must be authenticated with a valid OAuth token. Tokens are tied to user accounts; if you’re just using the API for a single user or organizer, then follow ‘Personal Tokens’ if you’re using the API for many marketo users, then follow ‘OAuth Token Flow’. which you can find in your marketo Account. The second argument is an options object which can contain the following options:

required options:

• token

available options

• version The API version to use. Defaults to v3.
• userAgent Custom User-Agent description to use in the request header.
• contentType defaults to application/json and currently the api only supports json

The callback function for each API method gets two arguments, an error and results object.

The error object is null when no error occured. The results object contains all information retrieved as long as no error occurred.

Example:

var Marketo = require('node-marketo');

var client;

try {
  client = marketoAPI();
} catch (error) {
    console.log(error); // the options are missing, this function throws an error.
}
client = marketoAPI({
    username: process.env.USERNAME,
    password: process.env.PASSWORD
  });

// IF you have an oauth token, you can use that instead. 
token = 'a users marketo API token';
client = marketoAPI({token: token});


// login
// - will confirm that the username/password is correct.
// - will conrirm that the WSDL is correct. 

client.login({}, function (error, data) {
  
    if (error) {
        console.log(error.message);
    } else {
        console.log(JSON.stringify(data)); // Do something with your data!
    }
});

License

node-marketo is licensed under the MIT License. (See LICENSE)

Contributors