---
title: "Google Workspace - Setup Service Account and JSON file"
canonical: "https://helpcenter.mindproapps.com/space/sync/2196799489/Google%20Workspace%20-%20Setup%20Service%20Account%20and%20JSON%20file"
format: markdown
---
> ℹ️ **Summary: **Learn how to set up your Google Workspace service account and generate the JSON file to establish the connection with Mindpro Sync. If you want more information about how to create a service account, click [here](https://support.google.com/a/answer/7040511?hl=en&sjid=5457302430377366280-SA#zippy=%2Cstep-create-a-project).


### **Create a Service Account**


> ⚠️ **Important**:
> ⚠️ 
> ⚠️ All steps below require a Google Workspace Admin access.


To create a service account, open the Google Workspace API Console and create a project. You can use an existing one, if available. Click [here](https://console.developers.google.com/projectcreate) to learn more:

![Mindpro-1759526877929-2x.png](media://93c435d0-05e8-4731-a518-16e6a2445be0)


From the "AIM & Admin” section, click on the “Service Accounts” option from the left panel. Then, click on the “Create Service Account” option from the top menu:

![Mindpro-1759526938501-2x.png](media://f042adfe-3940-47bc-9edf-8437aa87ab2d)


From the “Service Account Details” section, enter the account name, ID, and also a description for the related service account. Then, click on “Create and Continue”:

![Mindpro-1759526984281-2x.png](media://3899595c-abba-4d6b-869b-060662861b9c)

    

From the “Grant this service account access to project” section, select the "Project” option from the left panel and then “Owner” from the right panel as the role to be used. Then, click on “Continue":

![Mindpro-1759527021348-2x.png](media://440ca80f-af39-4613-86fb-e420ccd89ced)


Now you have your service account created! 

Edit the service account just created and go to the “Keys” tab. Click on the “Add key” button, and select “Add New Key”:

![Mindpro-1759527083353-2x.png](media://abf2dd46-2666-4897-9eba-7fc90a6f2678)


Select the key type as “JSON” and click on “Create". Then, save the file created.

![Mindpro-1759527165790-2x.png](media://ac7b68c5-41b4-4ca0-96d4-c0912a9b1616)


> ℹ️ Important:
> ℹ️ 
> ℹ️ The file created is unique. In case you do not save it, a new one needs to be generated.


### **Enabling your Admin API**


Go to the [Google Workspace API Console](https://console.developers.google.com/) and open the project just created. From the top menu, select the “Enable APIs and Services” option:

![Mindpro-1759527222484-2x.png](media://54309ff0-aa97-4bd8-918f-6b64d5c750f5)


From the API list displayed, search for “Admin SDK API” and click on this option from the list:

![Mindpro-1759527283043-2x.png](media://376d752f-ee01-4266-94b8-166a0abf0e07)


On the next screen, click on “Enable”:

![Mindpro-1759527322137-2x.png](media://1bdb2c01-4287-4a32-8867-e0d77782545b)


### **Assign OAuth scopes for the SDK API**


After enabling the API, access your Google Workspace [Admin Console](https://admin.google.com/). From the left panel, access the “Security” menu, and then click on the “API Controls” option:

![Mindpro-1759527365109-2x.png](media://0b87083b-6755-4f46-b9c4-4ce517fa67ff)


Locate the “Domain wide Delegation” panel and click on the “Manage Domain Wide Delegation” link:

![Mindpro-1759527410684-2x.png](media://2fc78699-d5af-478d-a81e-1612c2e4c717)


Next, click on the “Add New” from the “Manage Domain Wide Delegation” page and enter your service account client ID.

> ✅ **Info**
> ✅ 
> ✅ Your service account client ID is available in the JSON file previously generated. You can also find the ID in the [Google Cloud Console](https://console.developers.google.com), in “**IAM & Admin->Service Accounts**”.


Under the OAuth Scope section, enter the related scopes you want to give to the application. For Mindpro Sync, the “Read Only” access is enough. Here is the OAuth scope for this:


```
https://www.googleapis.com/auth/admin.directory.user.readonly,https://www.googleapis.com/auth/admin.directory.group.readonly,https://www.googleapis.com/auth/admin.directory.group.member.readonly,https://www.googleapis.com/auth/admin.reports.audit.readonly,https://www.googleapis.com/auth/admin.reports.usage.readonly,https://www.googleapis.com/auth/admin.directory.user.security,https://www.googleapis.com/auth/drive.readonly,https://www.googleapis.com/auth/admin.datatransfer.readonly
```


![Mindpro-1759527457067-2x.png](media://af581218-5383-4c78-b2ed-45056fc28648)


### **Next Step: **

[Configuring Google Workspace connection in Jira](https://mindpro.atlassian.net/wiki/spaces/sync/pages/2040430593)


---

### **Need any help?**

Didn’t find what you were looking for? Raise a ticket [here](https://mindpro.atlassian.net/servicedesk/customer/portal/3) or get in touch at [support@mindproapps.com](mailto:support@mindproapps.com)