Legacy Apps let you send feed events to Blink users through the Feed API and retrieve Blink Forms and their submissions. This guide covers creating a Legacy App. These apps are only visible on the 'Manage Apps' page to all users in your organisation if you Enable your app.

Creating a Legacy App

Navigate to the 'Manage Apps' tab in the Blink admin panel.

Select the Created apps tab and click Create app in the top right.

Choose Legacy App option and specify the name for your app:

Once your Legacy App is created, you'll need to configure and enable it using this form:

Configuration

App Name - the name of your app. This is shown to users of your app on the manage apps page in the main app.

Description - this is an internal description about what the app does only visible via Admin Portal.

What does the user get from this app in Feed? - this a description of the app that is visible to the end users.

Post categories - each post category has two fields, Category Id and Description. The Id is what is sent in the category field when calling the Send Feed Event endpoint. The description is displayed to the user on the app management page next to a toggle. The toggle allows the user to choose whether or not they want to receive feed events in that category from that app.

Generating Tokens

To use the Feed and Forms API, you need to generate a token for your app. Click Add token at the bottom of your app's page and your token will be displayed. You can have up to two tokens active at one time, allowing you to generate a second token then migrate your app's code to using it.

To use a token, copy it from the text box and send it in any requests to the API as an Authorization header with the value Bearer <your token>.

Enabling your App

For users in your organisation to be able to see your app on the manage apps page, you need to enable your app. To do this simply click the Enable App button on the management page for your app in the admin panel:

Once your app is enabled, users will be able to see the app on the apps management page and configure which feed posts they receive from it. If the app is an authenticated app, they will be able to see the prompt to connect to the app.

Disabled apps can still post to user's feeds to allow testing your app before you expose it to your organisation. However, to avoid confusion, we advise only sending feed events to a small number of users until your app is enabled. Otherwise users in your organisation may be confused as to where the feed events they are receiving are coming from.