Skip to main content

​
Generate a Service Account Token

A Service Account Token provides programmatic access to your Grafana instance.

1

Sign in to Grafana

Sign in to your Grafana account.

  • Navigate to Administration > Users and access > Service Accounts.
2

Create a Service Account

Click Add service account and configure the following.

  • Enter a descriptive name (e.g., StackOne Integration).
  • Select the Admin role for full access, or select No Basic Role and select individual permissions (see below).
3

Select permissions

Enables actions: Add Organization User, Add Team Member, Create Alert Rule, Create Annotation, Create Contact Point, Create Correlation, Create Dashboard, Create Data Source, Create Folder, Create Library Element, Create Mute Timing, Create Playlist, Create Service Account, Create Service Account Token, Create Snapshot, Create Team, Delete Alert Rule, Delete Annotation, Delete Contact Point, Delete Correlation, Delete Dashboard, Delete Data Source, Delete Folder, Delete Library Element, Delete Mute Timing, Delete Playlist, Delete Service Account, Delete Service Account Token, Delete Snapshot, Delete Team, Get Alert Rule, Get Dashboard, Get Dashboard Permissions, Get Dashboard Version, Get Data Source, Get Folder, Get Folder Permissions, Get Home Dashboard, Get Library Element, Get Mute Timing, Get Notification Policies, Get Organization, Get Organization Preferences, Get Playlist, Get Service Account, Get Snapshot, Get Team, List Alert Rules, List Annotation Tags, List Annotations, List Contact Points, List Correlations, List Dashboard Tags, List Dashboard Versions, List Data Sources, List Folders, List Library Elements, List Mute Timings, List Organization Users, List Playlists, List Service Account Tokens, List Service Accounts, List Snapshots, List Team Members, List Teams, Remove Organization User, Remove Team Member, Search Dashboards, Star Dashboard, Unstar Dashboard, Update Alert Rule, Update Annotation, Update Contact Point, Update Dashboard Permissions, Update Data Source, Update Folder, Update Folder Permissions, Update Library Element, Update Mute Timing, Update Notification Policies, Update Organization, Update Organization Preferences, Update Organization User Role, Update Playlist, Update Service Account, Update Team

If not using Admin role, select the permissions for your use case:

4

Generate a token

Click on the newly created service account, then click Add service account token.

  • Enter a token name (e.g., stackone-token).
  • Optionally set an expiration date.
  • Click Generate token and copy the token immediately — store it securely for use later.

​
Find your instance URL

Your instance URL identifies your organization’s Grafana environment. Include a trailing slash.

  • Check your browser address bar when signed in to Grafana.
  • Format: https://{your-org}.grafana.net/
  • Example: if your URL is https://acme.grafana.net/dashboards, your instance URL is https://acme.grafana.net/
  • For self-hosted instances, use your Grafana domain (e.g., https://grafana.yourcompany.com/)

​
Linking the Account from the Hub

1

Navigate to the Hub

Use one of the three Linking Account Methods to access the Hub.
2

Fill out the fields

Fill out the following fields using details from your provider:
  • Service Account Token
  • Instance URL
3

Connect

  • Click Connect
  • If applicable, the provider will redirect you to a sign-in or authorization page. Complete the provider’s authorization flow.
  • Once authorization is successful, you will see a confirmation popup

If the account linking is successful, you will see the newly linked account in your Accounts page.