Google Apps (Gmail) Integration


Amity's integration with Google Apps (Gmail) imports email messages and stores them as Amity engagements. Once enabled, the integration will check for new messages every 30 minutes.



Amity uses a Google service account to access email in your company's Google Apps domain.

Before Amity can import email from Google Apps (Gmail), you must ask your Google Apps system administrator to do the following:

  1. Enable API access
  2. Grant API client access to Amity's service accounts 


Step 1 - Enable API Access

1. Log into

2. Click on the Security icon in the Admin console section.  Note, if you do not see the Security icon, click on the More Controls button at the bottom of the page.

3. Click on API reference.

4. Look for the API access section.  Click the Enable API access checkbox.

5. Click the Save changes button.  It is located at the bottom


Step 2 - Grant API client access to Amity's service accounts

1. Scroll down, select Show more, and click on Advanced settings.

2. Look for the Authentication section.  Click on Manage API client access.

3. Copy the value for the client name into the box labeled "Client Name".  There is unique client name for each Amity system.

Amity System Client Name
Production (

4. Copy the following API scopes into the text box labelled One or More API Scopes.,,

5. Click Authorize.

6. Repeat steps 3-5 with the following client name for the Amity sandbox system:

Amity System Client Name
Sandbox (


Step 3 - Notify Amity

Once step 1 and 2 are complete, notify your Amity representative so they can enable the integration.

Be sure to provide the email address of at least one of your Google Apps system administrators.



Email messages can consist of multiple parts. Each part has a type.  The types are plain text, HTML text, and binary file attachments (photos, documents, spreadsheets, etc.)

Email software like Gmail, Apple Mail, Hotmail, etc. can parse all types. Amity does not parse HTML text or binary attachments. Our implementation is currently limited to plain text.

That means that if the email only contains an attachment or HTML text, the message body will appear empty in the Amity engagement.

This limitation is rarely a problem because the vast majority of email applications will generate both plain text and HTML text whenever a message is created.


Have more questions? Submit a request


Please sign in to leave a comment.
Powered by Zendesk