node-red-contrib-monzo

This is a node-red package that will allow you to retrieve information from monzo. (this is not an official node developed by monzo)

Please Note - Monzo is a bank that is currently only available for UK residents.

This is an easy to use node, all you have to do is input a access token and select what information you want under the request dropdown.

• Installation
• Getting your temporary AccessToken
• Getting your permanent AccessToken
• Usage
  • Monzo-in
    • Capabilities
  • Monzo-out
    • Capabilities
  • Monzo-hook
    • Capabilities

Installation

Install via npm

npm install node-red-contrib-monzo

Getting your temporary token

To get your access token you will need to go to "https://developers.monzo.com/api/playground" and log in with your monzo account, you will see your access token on the playground page. This token will last roughly 6 hours.

Getting your permanent token

In order to have permanent authentication, this will require you to set up a monzo API client see "https://developers.monzo.com/apps/new", so that you can have a clientID and a API secret. (please note, the client will need Confidential set to TRUE, otherwise it will not automatically refresh). If node-red is left not running, the system will lose its window to refresh its token, meaning the next time you run node-red, your token will be invalid. You will need to re-authorise.

Please note as of recently in order for your permanent token to work, in the authentication process, after this node has said successful authentication, You will get a notification on the monzo app that you will have to allow.

How to use these nodes.

After you have placed either nodes, enter its credential configuration, you can either add a temporary token or a clientID and API secret. If you added the clientID and secret you will now need to go through the authentication process by clicking "Authenticate With Monzo". Once a access token is added, you are ready to go.

Monzo-in

select the request type you would like to do. To make a request simply inject anything into the input node to get a response from the output node.

Capabilities

This node can retreive three kinds of information from your monzo account.

• Account Information
• Balance Information
• Pots

Monzo-out

Monzo out node has specific requirements in configuration before a request can be successfully made, you must first select or create an authenticated token, then enter an accountID of which changes will be made. Then select the request type, this will dynamically create the new fields to be filled in. Once all fields have been filled in you will be able to make a request. (If you need to find out what the accountID or potID is. use the monzo-in node to find these.)

Capabilities

This node can retreive three kinds of information from your monzo account.

• Pot Deposit
• Pot Withdraw
• Create Feed Item (Planned)

Monzo-hook

Monzo Hook is a node that is used to manage and control webhooks for monzo, it also sets up automatic hook urls and receives the notifications which are then sent out of the node.

Capabilities

This node can retreive notifcations from registered webhooks on monzo for live notifications, it can also set up remote url hooks if you would like to receive the webhook notifications elsewhere.