In order to access secured endpoints, either manually or programmatically, Marfeel offers a token based authentication method called the Secret Key. This token is generated in Insight and is used by adding it in a header called "mrf-secret-key".


The Secret Key is like a password and should therefore, remain private. Please to not make it appear in the url (no query param).

It should be generated from a user's proprietary Insight account through the steps outlined below.

Generate and view the authentication token

  1. Log in to Insight.
  2. Click your user name in top-right corner of the page and select User Account in the drop-down menu.
  3. The token is displayed in the Secret Key field. 

Change the authentication token

  1. Click Change in the Secret Key field of the Marfeel user details page and a new key is automatically generated.