Documentation for automated readers
A curated documentation index is available at: https://grafana.com/llms.txt
A complete documentation index is available at: https://grafana.com/llms-full.txt
These indexes can help with page discovery before fetching individual documents.
This page is also available in Markdown, which may be easier for automated readers and AI tools to parse than HTML. The Markdown version is available at https://grafana.com/docs/grafana/v8.5/administration/service-accounts/create-service-account.md, or by sending Accept: text/markdown to https://grafana.com/docs/grafana/v8.5/administration/service-accounts/create-service-account/. For broader documentation discovery, the curated index is available at https://grafana.com/llms.txt and the complete index is available at https://grafana.com/llms-full.txt.
Important: This documentation is about an older version. It's relevant only to the release noted, many of the features and functions have been updated or replaced. Please view the current version.
Create a service account in Grafana
A service account is a user account that you can use to run automated or compute workloads. For more information about how you can use service accounts, refer to About service accounts.
For more information about creating service accounts via the API, refer to Create service account via API.
Before you begin
- Ensure you have added the feature toggle for service accounts
serviceAccounts. For more information about adding the feature toggle, refer to Enable service accounts. - Ensure you have permission to create and edit service accounts. By default, the organization administrator role is required to create and edit service accounts. For more information about user permissions, refer to About users and permissions.
To create a service account
- Sign in to Grafana and hover your cursor over the organization icon in the sidebar.
- Click Service accounts.
- Click New service account.
- Enter a Display name.
- The display name must be unique as it determines the ID associated with the service account.
- We recommend that you use a consistent naming convention when you name service accounts. A consistent naming convention can help you scale and maintain service accounts in the future.
- You can change the display name at any time.
- Click Create service account.
Was this page helpful?
Related resources from Grafana Labs


