Create a service account

Complete the following steps to create a service account for your migration or interop tool for G Suite.

Step 1: Create a project

  1. Go to the Google Developers Console and sign in as a super administrator.
  2. Create a new project by doing one of the following: 
    • If you haven't used the Developers Console before, agree to the Google Cloud Platform Terms of Service. Then, click Create a project.
    • At the top of the screen next to your most recent project name, click the Down arrow Down Arrow to open your projects list. Then, click Create Create to create a new project.
  3. Enter a project name and click Create.

Step 2: Enable the APIs

​Each tool uses a different set of APIs:

Tool Google Apps APIs
G Suite Migration for Microsoft® Exchange Admin SDK, Calendar API, Contacts API, Gmail API, Groups Migration API
G Suite Password Sync Admin SDK
G Suite Migration for IBM® Notes® Calendar API, People API, Gmail API, Groups Migration API

Note: If you are using GSMIN 5.1 or earlier, use the Contacts API instead of the People API.

Google Calendar Connector for IBM® Notes® Admin SDK, Calendar API
Google Calendar Resource Sync Admin SDK, Calendar API


To enable the APIs:

  1. Click the API name and then Enable.

    Tip: If you don't see the API, enter the API name into the search box.

  2. If you need to enable another API, click Back Back to return to the Google APIs page.

Step 3: Create the service account

  1. In the top-left corner of the console, click Menu Menu.
  2. Click IAM & Admin and then Service accounts.
  3. Click Create service account and in the Service account name field, enter a name for the service account. 
  4. (Optional) Assign the role of Project viewer to the new account.
  5. Check the Furnish a new private key box and ensure the key type is set to JSON.
  6. Check the Enable Domain-wide Delegation box and enter a name in the Product name for the consent screen field.
  7. Click Create. You'll see a message that the service account JSON file has been downloaded to your computer. Make a note of the location and name of this file. You will need it later.
  8. Click Close.
  9. If you are installing GSMME or GSPS:
    1. In the Options column, click the View Client ID link for the service account you have just created.
    2. Copy the Client ID value. You will need this later.

Important: By default, only the creator of the project has rights to manage the project. To ensure that the project can be maintained if the creator leaves the organization you should assign at least one other person the role of Project Owner.  For details, see Manage project members or change project ownership

Was this article helpful?
How can we improve it?