next() Packaged Middleware


    1.8.8 • Public • Published


    This is the Node.JS client library for the Convictional API.

    For more documentation, please visit our docs site. If you have any other questions, visit our support site.

    This is the best way to build apps on Convictional. This library offers complete test coverage across all RPC and REST endpoints and is used in production for all integration work that we do.

    The library will be updated as the API changes so ensure you keep it up to date.

    To install, type: npm install convictional

    To test, run: npm run test


    You can optionally pass configurations like your API key or API URL in like so:

    // Top of your file with all your requires:
    var convictional = require('convictional')({
      'apiKey': '86e7ccdc-55b5-4066-a79f-7a1e0e59c690'
    // ... later where you want to use it:
    var orderId = '5a692f658f6d524e8282dac7'
    convictional.getOrder(orderId).then((order) => {
      // Do stuff with order
    }).catch((error) => { console.error(error) })

    Or you can pass configurations on a call-specific basis:

    // Top of your file with all your requires:
    var convictional = require('convictional')
    // ... later where you want to use it:
    var apiKey = '86e7ccdc-55b5-4066-a79f-7a1e0e59c690'
    var orderId = '5a692f658f6d524e8282dac7'
    convictional.getOrder(orderId, apiKey).then((order) => {
      // Do stuff with order
    }).catch((error) => { console.error })


    • Methods start with the HTTP method and end with the resource: getOrders, postProducts, etc.
    • The first parameter is a string, object or array with the payload for the request.
    • The optional second parameter is the API key for the account you are using.
    • The optional third parameter is the API URL, defaults to main API url:
    • All methods return promises, so you must use then/catch verbs to handle them.

    Method usage example

    var query = { 'shipped': false }
    .then((orders) => { // Do stuff with [orders] })
    .catch((error) => { console.error(error) })

    List of methods

    Actions (RPC)

    • sync(method) - GET (runs and queues) one method, by method name
    • translate(doc) - POST (translate) one document, by document
    • invite(email) - POST (invites) one partner, by partner
    • quickOrder(order) - POST (orders) an order by partner

    Orders (REST)

    • getOrder(id) - GET (read) one order, by ID
    • getOrders(query) - GET (read) many orders, by query
    • postOrder(order) - POST (create) one new order, by order object
    • putOrder(order) - PUT (update) one order, by order object
    • putOrders(orders) - PUT (update) many orders, by array of orders
    • deleteOrder(id) - DELETE (delete) one order, by ID

    Products (REST)

    • getProduct(id) - GET (read) one product, by ID
    • getProducts(query) - GET (read) many products, by query
    • postProduct(product) - POST (create) one new product, by product object
    • putProduct(product) - PUT (update) one product, by product object
    • putProducts(products) - PUT (update) many products, by array of products
    • deleteProduct(id) - DELETE (delete) one product, by ID

    Partners (REST)

    • getPartner(id) - GET (read) one partner, by ID
    • getPartners(query) - GET (read) many partners, by query
    • postPartner(partner) - POST (create) one new partner, by partner object
    • putPartner(partner) - PUT (update) one partner, by partner object
    • putPartners(partners) - PUT (update) many partners, by array of partners
    • deletePartner(id) - DELETE (delete) one partner, by ID

    Prices (REST)

    • getPrice(id) - GET (read) one price, by ID
    • getPrices(query) - GET (read) many prices, by query
    • postPrice(price) - POST (create) one new price, by price object
    • putPrice(price) - PUT (update) one price, by price object
    • putPrices(prices) - PUT (update) many prices, by array of prices
    • deletePrice(id) - DELETE (delete) one price, by ID


    npm i convictional

    DownloadsWeekly Downloads






    Unpacked Size

    73.1 kB

    Total Files


    Last publish


    • jakestrang
    • rogerkirkness