I updated the api docs for the /notifications endpoint and started a howto for this that we can build upon:
/notifications