Skip to content
Switch branches/tags
Go to file

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time

Node wrapper for Fancyhands' API

For more information visit the Fancyhands API Docs

##Installation If you don't have node installed, get it at

Then run:

npm install fancyhands-node --save

##Getting your Key and Secret Go to the Fancy Hands API site to get your OAuth credentials.


var FH = require('fancyhands-node').fancyhands;

// Configuration

// Create a Standard Request
var request = {
	title: 'Test Request, do not claim!',
	description: 'Do not send to support',
	bid: 3

// Send the request.
// The method returns a promise. Use the 'then' method to pass in response and error handlers.
	.then(function(request) {
		// print out what we got
		console.log("Success! Request created");		
		// send a message to this request...
		FH.message_send({ key: request.key, message: "And one more thing..." })
			.then(function(data) {
				console.log("Success! Message sent");

FH.standard_request_get().then(function(data) {
	var requests = data.requests;
	for(var i = 0; i < requests.length; ++i) {


All methods return a promise. We use the Q Promise Library, read more about it here.

Utility url, params (Object) )
Manual POST to Fancyhands. Can use any API method.

FH.get( url, params (Object) )
Manual GET from Fancyhands. Can use any API method.

FH.put( url, params (Object) )
Manual PUT to Fancyhands. Can use any API method.

FH.delete( url, params (Object) )
Manual DELETE from Fancyhands. Can use any API method.

FH.echo( <params Function|Object|number|string> )
We'll echo back whatever params you send. Use to test your API key and secret.

Incoming Calls

FH.incoming_call_create( params (Object) )
Allows you to create a new Incoming Call Object, with custom built script for our assistants to read.

FH.incoming_call_get( params (Object) )
Retrieves a list or specific Incoming call objects

FH.incoming_call_update( params (Object) )
Updates an Incoming call object

FH.incoming_call_delete( params (Object) )
Deletes an Incoming call object

FH.incoming_call_history( params (Object) )
Gets a list of all calls made on an Incoming call object

FH.number_search( params (Object) )
Search for an available phone number to buy and returns a list of them

FH.number_buy( params (Object) )
This method allows you to purchase a phone number that will be used as your incoming call display number.

FH.number_delete( params (Object) )
his method allows you to delete a previously purchased number, you will no longer be billed for it.

Outgoing Calls

FH.outgoing_call_create( params (Object) )
Specifically for making phone calls and getting structured data back. Super fast!

FH.outgoing_call_get( params (Object) )
Returns list of created calls

Custom Requests

FH.custom_request_create( params (Object) )
Make a request and get customized structured data back.

FH.custom_request_get( params (Object) )
Returns list of created custom requests

FH.custom_request_cancel( params (Object) )
Cancel a request before you get billed for it.

Standard Requests

FH.standard_request_create( params (Object) )
Make a request and get freeform data back.

FH.standard_request_get( params (Object) )
Return list of created standard requests.


FH.message_send( params (Object) )
Send a message to the assistant working on a task


A node module for the Fancyhands API



No packages published