How to create a service account

Tags: Flow

Creating a service account allows you to import all of your organization's repos and manage API keys under one generic user and integration without having to worry about exposing access to personal repositories, permission changes, staffing changes, loss of repo access, etc.

The curious case of Joe Moonlight

Consider the case of Joe Moonlight who works for the company but gets paid on the side for two moonlighting projects. Joe connected Flow to his personal GitHub account. He imported his company’s repos but obviously didn’t import his two moonlighting projects or his personal repos. 

After the release, anyone with the permission Manage integrations will see Joe’s list of organizations including his two moonlighting projects and his personal user.  

In this case, Joe should set up a service account on GitHub that only has access to his company account, transfer work related repos to the service account, and delete his personal login.  In many cases, Joe can also revoke access to these projects from within GitHub. 

If your account is connected to any repos that would be inappropriate for the company to have access to, then you should move to a service account.  

back to top

Creating a service email

In order to create a service account within Flow, you will need to create a service email address if you do not already have one for user functions in your organization. It can be anything from “” or “”. Once you have a functioning email you can add the “user” to your Flow account. 

Tip: This service email will need the appropriate permissions within your Git host in order to be able to import and manage your repos within Flow.

back to top

Adding the service email to your Flow account

  1. Starting on your Flow home page, go to the top navigation bar and click Settings. Using the left navigation under User Management click Users. 
  2. Click the Invite Users button. 
  3. Type in the service email you created. Give the appropriate access and permissions needed to manage integrations and repositories.
    Note: We recommend the service user be set as an Owner. Owners have access to everything. Their view rights can also be set to view all teams and individual contributor metrics.  If you want this service account to manage the import of all your repos or manage API keys, set the user permissions to Manage integrations and/or Manage API keys. Learn more about administrative permissions.

  4. Click Send.
  5. You have successfully sent an invitation to this service email. Now you will need to access the service email and go through the steps of logging into your Flow account. Once you are successfully logged into Flow, import your repos and manage your API keys just like you would normally.

back to top

If you need help, please email for 24/7 assistance.