Create an App

Creating a new App and getting API credentials

Start in the VARIO Cloud Admin-Center: https://admin.vario.cloud

Step 1 – Open the Developer Menu (This has to be activated for you by the VARIO AG)

1. Sign in to the VARIO Admin-Center.

2. In the left-hand navigation, select “Entwickler” (Developer).

This opens the Developer view where you see a list of your existing Apps.

Step 2 – Start the “Create App” dialog

1. In the Developer view, locate the buttons in the header toolbar on the top right.

2. Click “App erstellen” (Create App).

A dialog titled “Neue App erstellen” (Create new App) will open. It contains a single text field labeled “App-Manifest”.

Step 3 – Paste the App manifest

To define your new App, you must provide a valid App manifest in JSON format.

1. Prepare your manifest JSON locally.

2. Paste the JSON into the App-Manifest field.

3. Click “Anlegen” (Create).

EXAMPLE APP MANIFEST

{
  "appVersion": "1.0.0",
  "label": "Demoapp",
  "description": "Just a demo app",
  "shortName": "demoapp",
  "rootUrl": "https://app.example.com/",
  "pcInstallationUrl": "https://app.example.com/ui/install.html",
  "pcInstallationDeletionUrl": "https://app.example.com/ui/uninstall.html",
  "pcManifestUrl": "https://app.example.com/manifest",
  "requirements": {
    "licenseKey": "app_demo_license_key",
    "permissions": [
      {
        "resource": "crm-activity",
        "verb": "read"
      },
      {
        "resource": "crm-activity",
        "verb": "create"
      }
    ]
  },
  "authorizationVerbs": [
    {
      "verb": "use-app",
      "description": "Allowed to use the demo app"
    },
    {
      "verb": "add-activity",
      "description": "Allowed to add activities"
    }
  ],
  "uiIntegrations": {
    "integrations": [
      {
        "pointOfIntegration": "navigation.root",
        "id": "demo-page",
        "url": "https://app.example.com/ui/demo.html",
        "iconClass": "fal fa-atom-simple",
        "msgKey": "Demoapp",
        "permissionKey": "use-app"
      },
      {
        "id": "demo-dialog",
        "url": "https://app.example.com/ui/demo-dialog.html"
      },
      {
        "id": "demo-vr",
        "url": "https://app.example.com/ui/demo-vr.html"
      }
    ]
  }
}

At this point, you have defined:

• basic App metadata (label, description, appVersion)

• licensing and visibility (uniqueLicenseKey, privateApp, dedicatedApp)

• URLs for the App backend and UI (rootUrl, pcInstallationUrl, pcInstallationDeletionUrl, pcManifestUrl )

• required permissions for the APP (access to the activity table in this case) under requirements.permissions

• custom authorization permissions that can be assigned to users

• UI integrations (for example, a navigation entry via pointOfIntegration: "navigation.root")

Step 4 – Copy your API credentials (AppClient)

After you create the App successfully, VARIO-Cloud will generate OAuth2 client credentials for this App:

{
  "appIdentifier": "your-app-identifier",
  "clientId": "your-client-id",
  "clientSecret": "your-client-secret",
  "appJWK": "JWK_TOKEN"
}

Important appIdentifier, clientId, clientSecret and appJWK are shown only once. You must copy these values immediately and store them securely (for example in a password manager, a secrets vault, or environment variables used by your App).

These values are what you will use later to authenticate against the VARIO-Cloud API (e.g. when requesting OAuth2 tokens) and to verify the APP_JWK Token.

Once you have copied and stored these credentials, you are ready to continue with authentication (e.g. OAuth2 Refresh Token grant) and actual API calls.