Skip to main content
Gainsight Inc.

Configure Email to Timeline (Beta)

Note: This feature is currently being piloted by a small group of customers starting in late November 2018, and we are not accepting additional participants at this time. We will gather feedback from the beta program, and make enhancements to the feature before we release it broadly. Currently, we anticipate a general release in 3 - 4 months. 


Gainsight now enables users to log customer communications as Timeline Activities using a unique inbound email address. Previously, CSMs had to copy and paste customer email content from their inbox to a Timeline activity. Now, using the unique inbound email address, CSMs can automatically log their customer emails to Timeline for accounts and relationships. This feature helps you record your history of significant interactions, so CSMs, Execs, and Sale reps, for example, can quickly get up to speed and understand the customer relationship by reviewing Timeline.

While this feature is in Beta, it must be enabled by Gainsight. Once the feature is enabled, Admins will add their list of users, and a unique inbound email address will be generated that CSMs will use to logs customer emails as activities on Timeline.

Use 'Email to Timeline' to capture email sent from external email applications such as IBM® Lotus Notes® and Microsoft® Outlook® and with webmail such as Gmail® and Yahoo! Mail®. Email to Timeline attempts to match the email address (domains) in the To, CC, and Bcc fields with the address in the Email standard field. Email to Timeline doesn’t support matching on custom email fields. Gainsight ignores invalid email IDs or domains which you have not included while configuring email.

Note: You can only use the text email version of the enhanced email message. Images or screenshots will be added as attachments.

For a short video introduction to this feature, click here!

Prerequisites and Beta Program

  • If you have registered for the Beta program of Email to Timeline, your org should be above 5.19.3 version in order to use this feature.
  • Confirm that Email to Timeline feature is set as True in your org. 
  • Ensure that required person records are added to Gainsight. They can be added from C360 > Person section > +PERSON when the Person associated with a specific Company or Relationship respectively.
    Note: For Persons, the bulk upload option is available from Rules using Load to Company Person and Load to Relationship Person. For more information, refer to the following documentation:
  • Currently, the Email to Timeline feature is in Beta and must be enabled for individual customers. This allows customers to opt-in to the beta, and do some early experimentation. Based on your valuable feedback, Gainsight will make improvements to the functionality.
    Note: For general guidelines, refer Email to Timeline(Beta) for End Users. You can also refer to the following Email to Timeline flowchart.

Email to Timeline flowchart.PNG


  • The maximum number of inbound emails allowed is 100,000 per day per tenant.
  • Total Email Content + Attachments size limit is 20MB, and each attachment’s maximum supported size is 15MB.
  • Email to Timeline can create a maximum of 5k draft email activities per Tenant. After the limit is exceeded, Gainsight rejects the drafts.
  • In Admin, ‘SAVE’ is mandatory after add/delete of a user.
  • If the person is present in both company and relationship, Gainsight resolves it to relationship and posts the activity to the respective relationship.
  • If External recipients are not included in the To line, Gainsight saves the activity as draft.

Limitations which are identified & Planned to be Addressed in Future Release

  • Bulk User Enablement: The experience right now for customers is to select and add users manually one by one. We are working on providing the ability to add filters on User object and allow admins to enable this feature for bulk users.
  • Audit Logs: There are various combinations where an email sent to Gainsight can be rejected by the system. Some of the possible failure reasons are:
    • Per day Tenant Limit of 100,000 inbound emails
    • Author Email and inbound email mismatch
    • Author email not available as an internal user in Gainsight User object
  • Ability for admins to see the messages which have failed, added to draft and the reasons for the same is not available at this point.
  • User has to scroll to the bottom of the page and save for every action performed (user added or deletion).
  • Reply to the user via Email the status of their email which was posted to timeline. This is especially useful whenever the post to timeline fails or the post is added to drafts.

Configure Inbound Emails

To enable the Email to Timeline feature for users, perform the following steps.

  1. Navigate to Administration > Email Configuration.
  2. Click the INBOUND EMAILS tab.


  1. Select the Timeline checkbox in the Enable Inbound Emails section.


  1. Scroll up/down in the Users section that contains the list of names and email addresses of the users who were given access to send emails to Gainsight. Emails to Timeline sent by users without access will be discarded.
    Note: In the Users section, there are two search icons.
  • First search field known as search and select users is used to find a user and add in the list of users who have access to the Email to Timeline feature.
  • Second search field is to find out the specific user who is already added and can access this feature. This is way you can find out a specific user quickly.


  • Admins need to select and add users manually one by one. Gainsight Team is working on providing the ability to add filters on User object and allow admins to enable this feature for bulk users.
    IMPORTANT: Ensure that you click SAVE every time you add/delete any user.

    If you do not see the user/contact whom you want to add in the list of users with access to the Email to Timeline feature:
  • Navigate to Administration > Data Management > User Object > Data where you can check if the person record already exists.
  1. Enter a sub-domain in the Inbound Email Sub-domain section.
    Note: After saving, the sub-domain cannot be changed.


IMPORTANT: The sub-domain that you provide here will be used for generating inbound email addresses. The sub-domain should be 20 characters max, and formed from a set of letters, digits, dot and hyphens (a-z, A-Z, 0-9, -, .), but not starting or ending with a hyphen. Sample system generated email address with its sub-domain:

  1. Add domain(s) from which Gainsight should accept emails in the Acceptable Domains section. Gainsight identifies/validates only those emails with the domain(s) which are added in this section. This ensures an extra layer of security. Domain should be formed from a set of letters, digits, dots, and hyphens (a-z, A-Z, 0-9, -, .), but not starting or ending with a hyphen.


  1. Click SAVE.
    Note: As soon as you save the Inbound Emails configuration, a welcome email will be sent to those users who were added just now. For more information about the end-user’s experience with this feature, refer to the Email to Timeline(Beta) for End-Users article.
  2. (Optional) You may build a report by selecting Activity Timeline as the source object and include filter criteria with field ‘Source’ equals ‘INBOUND_EMAIL’ to see how many activities are created/logged via email integration.



Below are some questions about Email to Timeline feature functionality. If you have a question that's not answered here or through related support articles, please email or post them to Gainsight's Community.

  1. I enabled Timeline under the Enable Inbound Emails section, but it’s still not activated for my user. What could be the reason?
    If you forget to click the SAVE button after selecting the checkbox to enable inbound emails for Timeline, your user won’t see the inbound email option. Ensure that every time you make any changes, click SAVE.
  2. Can I Add users in the Administration > Email Configuration > INBOUND EMAILS tab?
    Yes, you can add. For more information, refer to the <section above>.
  3. Can I change the sub-domain that I added while configuring the Inbound Email?
    No, you cannot change the sub-domain once added and saved.
  4. Will the system generated email expire after using it for some time?
    No. Unless the admin revokes the access from the user, the inbound email address will remain valid.
  5. As an admin, will I receive an email confirmation as soon as the TechOps team enables this feature for the tenant?
    No. The techops team resolves the issue after enabling the feature and that notifies the support team member who later updates the customers.
  6. How can I provide support to my end-users to resolve any issue?
    For more information, refer to the Limitations section in this document.
  7. There is a list of users an admin adds, will all the users get any notification every time there is any update takes place?
    Yes. Each user will get a unique inbound email address which is automatically generated. After that if any new user is added in the list, only the new user will receive the welcome email.
  8. When I remove a user from the Users list, will the user be notified?
  • Was this article helpful?