> For the complete documentation index, see [llms.txt](https://docs.tonic.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.tonic.ai/fabricate/workspaces/gcp-service-accounts/gcp-create-manage-accounts.md).

# Creating and managing GCP service accounts

On the workspace settings page, the **GCP Service Accounts** section contains the list of available GCP service accounts.

<figure><img src="https://4109733485-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmoU4gTR9LxlzHeWmQCUZ%2Fuploads%2FEh4uuEYaNsvGjBWil1jd%2FWorkspace_GCPServiceAccounts.png?alt=media&amp;token=62614071-57ed-4724-9167-f6d04e639ef1" alt=""><figcaption><p>GCP Service Accounts list for a workspace</p></figcaption></figure>

## Adding a GCP service account

To add a GCP service account:

1. Click **Add Service Account**.
2. On the **Add GCP Service Account** panel, in the **Name** field, provide the name to use to identify the service account.\
   \
   After you save the service account, you cannot change the name.
3. Under **Identity Provider**, click the type of identity provider to use.
4. If you haven't already, [create the service account in GCP](#creating-and-configuring-the-service-account-in-gcp).
5. In the **Server Account Email** field, provide the email address of the service account.\
   \
   After you save the service account, you cannot change the server account email.
6. Complete the configuration for the selected provider type:

   * [Google Cloud](#using-google-cloud-as-the-identity-provider)
   * [External workload identity provider](#using-an-external-workload-identity-provider)

   The configuration includes steps in both Fabricate and in GCP. For the external workload identifier option, it also includes steps in the identity provider.
7. Optionally, in the **Note** field, provide a description of how the service account is used.
8. After you complete the configuration, to test the account, click **Test**.
9. To save the account, click **Save**.

## Editing a GCP service account

To change the configuration of a GCP service account:

1. Click the edit icon for the account.
2. On the account details panel, provide the updated account details.\
   \
   Note that you cannot change the **Name** or the **Service Account Email**.
3. To test the updated account, click **Test**.
4. To save the account, click **Save**.

## Deleting a GCP service account

You cannot delete a service account that is currently used by a server connection.

To delete a GCP service account:

1. Click the delete icon for the account.
2. On the confirmation panel, click **Delete**.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.tonic.ai/fabricate/workspaces/gcp-service-accounts/gcp-create-manage-accounts.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
