Step 1: Build Your Connector

• A. Create a new repo on your local machine

  (for help with this, check out GitHub's excellent doc )

• B. Add an auth.js file

  This where you handle all the specific authorization stuff for the Service

  module.exports = {
    handler : function (host, apiKeys, done, req, res) {
      var qs = require('querystring');
    }
    .
    .
  }
  

• C. Add some whatever.js files

  Next, create specific data collectors for whatever type of data you can extract from the API in question. Typically it will be contacts, photos etc. Below is an example of what it looks like to get all connections (contacts) from LinkedIN

  exports.sync = require('./lib').genericSync('connection', function(pi){
    if (!pi.config.connStart) {
      pi.config.connStart = 0;
  	return "people/~/connections?format=json";
    } else {
      return "people/~/connections?start=" + pi.config.connStart + "&format=json";
    }
  },function(pi, js){
      if (!js || !js.values) {
        pi.config.connStart = 0;
  	  return [];
  	}
  	if (js.values.length < 500) {
  	  pi.config.connStart = 0;
  	} else {
  	  pi.config.connStart += 500;
  	}
  	  return js.values;
  	});
  

Step 2: Prepare to publish

Once you are ready to publish your app (or at least see it in your Hubinga account), you will need to add a package file and push your work to GitHub — it will sync from GitHub to your Hubinga account automatically.

• A. Add a package.json file

  The package.json file in the root directory of your app specifies some basic info about your app. Minimally, you need at least these fields populated:

  {
    "author": "Me ",
    "name": "ServiceX",
    "description": "ServiceX Connector",
    "version": "0.0.1",
    "repository": {
      "title": "ServiceX",
      "handle": "servicex",
      "author": "Me",
      "update": "auto",
      "github": "https://github.com/CompanyStore/servicex",
      "type": "connector",
      "static": "false",
      "oauthSize": {
          "width": 491,
          "height": 163
      },
      "url": ""
    },
    "engines": {
      "node": ">=0.4.9"
    },
    "dependencies": {},
    "devDependencies": {}
  }
  

  Without those fields populated, your app will not be synced to your Hubinga account. For more info about the package.json file, see the package.json documentation .

• B. Add a screenshot

  Take a screenshot and put it in the root directory of your app as screenshot.png

• C. Push to GitHub:

  Commit your changes and push to GitHub.

  git add  .
  git commit -m 'ready to go'
  git push origin master

  Your Connector will be synced to your Hubinga account automatically.

Step 3: Publish your Connector to the Company Store!

Once your Connector is synced to your Hubinga account, it will show up in the "My Connectors" section under DEVELOP. Make sure everything is working, and then click the PUBLISH button in the header.

For more info, see the full publishing documentation .