Skip to content

Connect an external application

Guide revision 1 · Needs devices.view, devices.manage

Integrations manages organization-owned applications with scoped device access, tokens, and webhook delivery.

You need device viewing and management permissions. Decide the minimum device and read permissions the application needs.

  1. Open Integrations and create an application.
  2. Choose its name, allowed devices, and read permissions.
  3. Save the application and issue a token. Copy the newly shown token immediately into the receiving application.
  4. Use the displayed API base URL and organization/application identifiers.
  5. Configure a webhook if the application needs event delivery.
  6. Revoke the application when access is no longer needed.

The application can access only its granted devices and abilities. A newly issued secret is shown once; existing secrets cannot be retrieved later.

Changing grants invalidates the current token and disables/cancels webhook delivery. Issue a new token and reconfigure afterward. Revocation is permanent. If another editor changed the application, preserve your draft and review the conflict before choosing Reload latest state.

Read the related guide

Report a problem with this page