Skip to content


Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time



viewneo is a proprietary, cloud-based Digital Signage Software. You can use viewneo in conjunction with our pre-designed templates or create your own content within minutes. Additionally, users can integrate dynamic content like homepages, Facebook posts, in addition to weather and news RSS feeds. Our API allows you to access the full functionality of viewneo and embed your own programs, such as booking systems, into viewneo.



To communicate with the viewneo API you must have a valid access token in the requests Authorization header.

Personal Access Token

If you want to access the API in the name of your own account you should generate a personal access token. To generate a personal access token visit the API Settings in your viewneo account. Click on "Generate new token" and store it in a secure place.

Personal access tokens are valid until you remove them in your API dashboard.

Important: Treat your personal access tokens like passwords and never share them with anyone.


To access the viewneo API on a users behalf you can use OAuth2 to get an access token. To use this feature you have to create an OAuth client in your viewneo API settings.


Get authorization code (1. - 3.)

To obtain an authorization code, the user has to authorize access to their account.

In order to redirect the user to the authorization page, the first step is to first build the URL. Add the following key-value parameters as query string to the base url

Key Value
client_id Id of your OAuth client
redirect_uri 'Url encoded' callback URL to redirect the user after authorization. Important: This value has to match the redirect url you set in your client settings
response_type code

A valid redirect URL will look similar to this:

This is how the authorization page will appear.

authorization page

Once the user has authorized your client, they will be redirected to the redirect URL. The authorization code will appear where the parameter code is located below.

Get the access token (4. - 5.)

When you got your authorization code it's time to request your access token.

Just send a POST request with the following JSON to the viewneo OAuth token url.

Replace the capital values with your data.

  "grant_type": "authorization_code",
  "client_id": "YOUR CLIENT ID",
  "client_secret": "YOUR CLIENT SECRET",
  "redirect_uri": "",

Curl example:

curl -H "Content-Type: application/json" -X POST -d '{"grant_type": "authorization_code","client_id": "YOUR CLIENT ID","client_secret": "YOUR CLIENT SECRET","redirect_uri": "","code": "YOUR AUTHORIZATION CODE"}'

If everything is working properly it will look like this, otherwise, you will receive an error message outlining the problem.

  "token_type": "Bearer",
  "expires_in": 1296000,
  "access_token": "SOME ACCESS TOKEN",
  "refresh_token": "SOME REFRESH TOKEN"

Refresh expired token

If you want to refresh your access token before it expires. Just send the following JSON to the OAuth token url.

Replace the capital values with your data.

  "grant_type": "refresh_token",
  "refresh_token": "YOUR REFRESH TOKEN",
  "client_id": "YOUR CLIENT ID",
  "client_secret": "YOUR CLIENT SECRET",

Curl example:

curl -H "Content-Type: application/json" -X POST -d '{"grant_type": "refresh_token","refresh_token":"YOUR REFRESH TOKEN",client_id": "YOUR CLIENT ID","client_secret": "YOUR CLIENT SECRET"}'

Example Access Token Usage

Once you have a valid access token, the following is a simple curl request with authorization that is designed to get all of the playlists associated with your account the access token. Just replace YOUR_ACCESS_TOKEN with a real one.

curl -X GET -H 'Accept: application/json' -H 'Authorization: Bearer YOUR_ACCESS_TOKEN' ''

How-To Send Data

Data sent to the viewneo API should normally be in JSON format. For example if you want to create a playlist the JSON would look like this:

{"name":"My awesome playlist", "comment":"My awesome comment."}

Try the curl request:

curl -X POST -d '{"name":"My awesome playlist", "comment":"My awesome comment."}' -H 'Content-Type: application/json' -H 'Authorization: Bearer YOUR_ACCESS_TOKEN' ''

The response would look like this:

    "name":"My awesome playlist",
    "comment":"My awesome comment.",
    "updated_at":"2017-01-24 16:37:20",
    "created_at":"2017-01-24 16:37:20",


Docs for viewneo API







No releases published


No packages published