Gmail Add-on Installation and User Guide

The GivingData Interactions add-on for Gmail allows you to create GivingData interaction records directly from your Gmail email.

Install the Gmail Add-On

1. Navigate to the GivingData Interactions add-on in Google Workspace Marketplace.
2. Click Install and follow the prompts.
   
   
3. Navigate to your Gmail inbox and refresh the page.
4. Click the GivingData logo in the add-on menu.
   
   
   
5. Click the three dots icon, and then click Settings.
   
   
6. Enter the URL for your GivingData site.
   1. To obtain this, log into your GivingData site, copy the URL from the address bar, ending with “.com” (do not include “/#/”).
      
      
7. Enter the API Key from your Profile page in your GivingData site. Follow the steps below to obtain this:
   1. In your GivingData site, click your name in the upper navigation bar, and then click Profile.
      
      
   2. Click Integrations.
      
      
   3. If the API key has not yet been created, click Create API Key. Once created, click Copy to Clipboard.
      
      
   4. Paste the key in the API Key field in Gmail.
      
      
8. Click Save.
   

Create an Interaction from an Email

Follow the steps below to create a GivingData interaction from an email in your Gmail inbox.

1. Navigate to the email in your Gmail inbox.
2. Click the GivingData logo in the add-on menu.
   
   
3. Any organizations and requests with which this contact is related in your GivingData site populate. Select the organizations and/or requests to connect to the interaction being created with the email.
   
   
   
4. Click Create Interaction.
   
   
   
5. Click View in GivingData to navigate directly to the new interaction in your GivingData site.
   
   
   

A Gmail icon in the interaction indicates that the email was sent from Gmail.

Any documents attached to the email are available within interaction. Click the dropdown for the document to either download the attachment or create an interaction document from the attachment. It is recommended to take one of these actions.

Manage Email Replies in Gmail

If you or the original email sender reply in the Gmail email thread, the additional emails are not automatically added to the GivingData interaction. Follow the steps below to add them. 

1. Navigate to the email in your Gmail inbox.
2. Click the GivingData logo in the add-on menu.
   
   
   
3. Click Update Interaction.
   
   
   

The additional emails then appear in the interaction with a Gmail icon.