Skip to content
Developers

Build on vBoxxCloud

Connect your own software to vBoxxCloud with the REST API. Automate users and organisations, move files in and out, create share links and follow activity, on the same European platform your team already uses.

Terminal
# 1. Get an access token (password grant: scripts under your own account)
curl -X POST https://web.vboxx.nl/oauth/token \
  -d grant_type=password \
  -d client_id=anchor \
  -d username=you@example.com \
  -d password='your-password'

# 2. Call the API with the token
curl https://web.vboxx.nl/api/2/person \
  -H "Authorization: Bearer <access_token>"
Base URL
https://web.vboxx.nl/api/2
Authentication
OAuth2 bearer tokens
Tokens
Valid for about an hour, renewed with a refresh token
Transport
JSON over HTTPS only

Getting started

  1. 1

    Register an application

    An administrator opens the organisation settings, goes to API and chooses 'Register OAuth2 Client'. You get a client ID and a client secret.

    How to register
  2. 2

    Get an access token

    Apps that act for other users send them to the consent page (authorization code). Scripts under your own account can use the password grant.

    Access tokens
  3. 3

    Call the API

    Send the token in the Authorization header. When it expires, get a new one with the refresh token instead of asking for the password again.

    Authenticating requests

Good to know

  • Use a separate account for integrations, with only the rights it needs, so you can see and revoke what it does.
  • Accounts with two-step verification send the code as auth_code when they request a token.
  • GET /api/2/version needs no login: a quick way to test that you can reach the API.
  • Store client secrets and refresh tokens like passwords: never in the browser or in source code.

Need a hand?

Our support team in the Netherlands helps with API access, OAuth2 clients and integrations. Building something for many customers? Have a look at the partner programme.