# Doc: https://www.hipaatizer.com/docs/integrations/google-drive > LLM view for https://www.hipaatizer.com/docs/integrations/google-drive This file contains all documentation content in a single document following the llmstxt.org standard. ## Google Drive The Google Drive integration saves form submission files to your Google Drive account automatically each time a submission comes in. PDFs, CSVs, and any files patients upload all land there directly. It's a good fit for practices that want submission records in cloud storage without manually pulling files from the HIPAAtizer dashboard. :::caution[HIPAA Notice] If you intend to store Protected Health Information (PHI) in Google Drive, your Google Workspace account must be configured for HIPAA-compliant use. This includes a **Google Workspace plan that supports BAAs** (Business, Enterprise, or Education) and an active **Business Associate Agreement (BAA)** with Google. Google Workspace HIPAA compliance details ::: --- ## Prerequisites You'll need: - An active HIPAAtizer account with at least one published form. - A Google account (Google Workspace Business, Enterprise, or Education plan required if storing PHI). - A signed Google BAA if your forms collect Protected Health Information. --- ## Step 1: Connect Your Google Drive Account This is a one-time setup at the account level. 1. Go to **Integrations** (top menu) → Integrated Accounts → Google Drive. 2. HIPAAtizer connects via **OAuth**, no password is shared. You can revoke access at any time from your Google account settings. All files are stored under the root folder **`/HIPAAtizer`** in your Google Drive. 3. Click **Authorize**. You'll be redirected to Google to complete the authorization. :::warning[Important: Grant the Drive scope] On the Google permissions screen you'll see a checkbox for the scope **"See, edit, create, and delete only the specific Google Drive files you use with this app"**. **You must check this box** before continuing. If it's left unchecked, HIPAAtizer won't be granted access to Google Drive and the integration won't work. ::: 4. When it succeeds, you'll land back on the HIPAAtizer dashboard with the connection confirmed. --- ## Step 2: Enable Google Drive on Each Form Google Drive sync is configured per form, and each form saves its files independently. Enable and configure the integration separately for every form whose submissions you want sent to Google Drive. 1. Go to **My Forms** and click the **Form Settings** icon for the form you want to configure. 2. Open the **Integrations** tab and select **Google Drive**. 3. Check **Enable Google Drive sync for this form**. Three configuration sections will appear: **Folder Structure**, **File Prefix**, and **Files To Save**. --- ## Folder structure This controls how files are grouped inside your Google Drive. :::info HIPAAtizer creates all files inside the **`/HIPAAtizer`** folder in your Google Drive. This is the root that the **Folder Structure** settings build on, so any path you configure below is relative to `/HIPAAtizer`. ::: **Select Folder Organization Type:** - **By form** *(Recommended)*: Files are organized automatically, one folder per form name. The resulting path is `/HIPAAtizer/${form-name}/`. - **Custom path**: Lets you define a relative folder path using a template with dynamic variables. A **Folder Path Template** field appears where you can type a path and use the **Insert Fields & Variables** button to include values like form name, submission ID, date, or any form field. The default custom path template is: `${form-name}/${submissionId}`, which resolves to `/HIPAAtizer/${form-name}/${submissionId}/`. :::tip Use the **Insert Fields & Variables** button to browse all available variables, including form fields, submission metadata, and date values, to build a folder path that matches your filing conventions. ::: --- ## File prefix HIPAAtizer adds a prefix to every file it saves to Google Drive to prevent filename conflicts. (The base filename comes from your form's printable template and other settings.) **Select File Prefix Type:** - **Timestamp** *(Recommended)*: Prepends a timestamp to each filename, which keeps files unique and sorts them chronologically. - **Custom prefix**: Lets you define a prefix using a template. A **Prefix Template** field appears where you can enter a static value or use the **Insert Fields & Variables** button to build a dynamic prefix. The default custom prefix template is: `${date-today}` --- ## Files to save Select which file types get saved to Google Drive for each submission. All four are enabled by default: | File Type | Description | |-----------|-------------| | **Submission PDF** | A printable PDF of the completed form submission. | | **Submission CSV** | The submission data in CSV format, suitable for spreadsheet import. | | **Attachments (separate files)** | Any files uploaded by the patient are saved as individual files in Google Drive. | | **Attachments (single ZIP)** | All patient-uploaded files are bundled into a single ZIP archive. | Enable or disable any combination, then click **Save**. :::info You can enable **Attachments (separate files)** and **Attachments (single ZIP)** at the same time if you want both individual files and a combined archive saved for each submission. ::: --- ## Logs The **Logs** section at the bottom of the panel shows recent sync attempts for that form. Check here first if files aren't showing up in Google Drive. | Column | Description | |--------|-------------| | **Submission ID** | The HIPAAtizer submission that triggered the sync attempt. | | **Status** | Whether the sync succeeded or failed. | | **Details** | Additional information about the result or any error encountered. | | **Created At** | The date and time of the sync attempt. | --- ## Troubleshooting ### Files are not appearing in Google Drive Check the **Logs** section on the form's Google Drive Integration tab first. Common causes: - The Google Drive connection was revoked. Go to **Integrations → Integrated Accounts → Google Drive** and reconnect. - **Enable Google Drive sync for this form** isn't checked, or the settings weren't saved. - Your Google Drive storage quota is full. ### The Google Drive connection stopped working Google OAuth tokens can expire or get revoked. If syncing stops, go to **Integrations → Integrated Accounts → Google Drive** and re-authorize the connection. ### Error: Drive scope was not granted during authentication When you clicked **Authorize**, there was a permission request for the scope **"See, edit, create, and delete only the specific Google Drive files you use with this app"**. That checkbox wasn't enabled, so HIPAAtizer wasn't granted access. Please remove the integration and re-authenticate. When the Google permissions screen comes up, make sure you check that box before continuing. --- ## Related - [Dropbox Integration](https://www.hipaatizer.com/docs/integrations/google-drive/dropbox) - [Managing Form Submissions](https://www.hipaatizer.com/docs/integrations/submissions/managing-form-submissions) - [Email Notifications](https://www.hipaatizer.com/docs/integrations/form-builder/settings/email-notifications) - [Upload File Component](https://www.hipaatizer.com/docs/integrations/form-builder/components/upload-file)