Set up Data Sync with Google Cloud

Last Updated:

Pendo Data Sync provides the ability to export Pendo data (excluding Pendo Feedback data) to your Google Cloud Storage (GCS) account. Data Sync is a paid feature. Contact your Pendo representative to take advantage of Pendo Data Sync.

This article describes how to set up Data Sync with GCS.


You must be a subscription admin in Pendo to set up a destination as part of this process.

Setup overview

Data Sync is set up in Pendo and configured in your Google Cloud environment, and involves the following steps.

  1. Create a Google Cloud Platform (GCP) service account.
  2. Generate a JSON key file for your service account.
  3. Create a GCS bucket.
  4. Give the GCS bucket access to your GCP service account.
  5. Choose a provider in Pendo.
  6. Enter your service account key and bucket URL in Pendo.

Step 1. Create a GCP service account

If you don’t have one already, create a Google Cloud Platform (GCP) service account in your Google Cloud environment.

  1. In the Google Cloud console, navigate to IAM & Admin > Service Accounts and select Create service account.
  2. Add your service account details, including service account name and description.
  3. Optionally, choose an access level for your service account.
  4. Select Done. This creates a service account and role on the IAM Service Accounts page.
  5. Copy the service account name, which is in email format. Save this for use in Step 4 of this article.

For more information and instructions, see Google’s Create and manage service account keys.

Step 2. Generate a JSON key file for your service account

Regardless of whether you’re creating a new service account for Data Sync, or using an existing one, you must generate a JSON key file to add to your Data Sync destination in Pendo. To generate this key:

  1. In the GCP, navigate to the IAM Service Accounts page and find the service account you want to use for Data Sync.
  2. Under the Actions column, select the vertical dots next to your service account and select Manage keys.
  3. Select Create new key from the ADD KEY dropdown menu.
  4. Select the JSON key type and then CREATE
  5. This generates a message that tells you that your key has been saved to your computer, which you can then close.

Your key is now on your computer. Ensure you save your key for use in Step 6 of this article.

Step 3. Create a GCS bucket

Pendo-exported data is copied to a GCS bucket. To create a GCS Bucket:

  1. In Cloud Storage, navigate to Buckets and select + CREATE at the top of the page.
  2. Create a meaningful name for your bucket.
  3. Follow the Google workflow to choose a location and storage class for your data, how to control access to objects, and how to protect object data.
  4. Select CREATE.
  5. This generates a message that tells you that public access is prevented. Select CONFIRM.

You’re then taken to your empty bucket in Google Cloud.

Step 4. Give your GCS Bucket access to your service account

Grant Storage Admin access to the service account by making your GCP service account a member of the GCS Bucket. 

  1. In Cloud Storage, find your Data Sync bucket in Buckets, and either:
    • Open your Data Sync bucket, select the PERMISSIONS tab at the top and then GRANT ACCESS.
    • Select the vertical dots next to your Data Sync bucket in the Buckets page and choose Edit access.
  2. Grant access to your bucket by selecting Add principal and pasting your service account name, which you copied as part of Step 1 in this article.
  3. Under Select a role, select Cloud Storage > Storage Admin. This grants full control of GCS resources. Alternatively, create your own role, with specific requirements (storage.buckets.create).
  4. Select SAVE and verify that your service account has Storage Admin access to your Data Sync bucket.

Step 5. Choose a provider in Pendo

Before you can send data to your storage bucket, you must set a target destination in Pendo.

  1. In Pendo, navigate to Settings > Data Management.
  2. Select the Bulk Exports tab at the top and then Set Up Destination.
  3. Hover over the Google Cloud Storage tile in the slideout on the right, and then Select Provider. The slideout then summarizes the next steps for you.


Step 6. Enter your service account key and bucket URL in Pendo

The final step is to upload the service account key and provide the bucket URL to Pendo.

  1. Enter your bucket URL. You can find this in the CONFIGURATION tab of your Data Sync bucket created in Google Cloud Storage > Buckets. Copy the URL in the gsutil URI row of the Overview table.
  2. Enter the service account email name that corresponds to the JSON key file that was created and downloaded in Step 2 of this article.

  3. Enter the private_key value from the service account JSON key that was created and downloaded in Step 2 of this article.


  4. Select Validate Destination to test the credentials you entered.
  5. When successfully validated, select Create Destination.