Skip to main content

Export conversations data to cloud storage

Export all of your customer conversations data to Amazon S3 or Google Cloud Storage with data export.

Beth-Ann Sher avatar
Written by Beth-Ann Sher
Updated over 3 weeks ago

With Intercom's data export feature, you can export all of your customer Conversations to Amazon S3 or Google Cloud Storage for:

  • Reporting and analytics

  • Single Customer Views

  • Data quality and governance

There are export options for:

  • API version: Select the exported conversation data schema.

  • Output format: JSON or JSONL.

  • Attachments: Conversation part attachment exports.

  • Historical: A two year export of all conversations data.

  • Periodic: Continual Hourly or Daily exports of new and updated conversations data.


How to export data to cloud storage

1. Navigate to Settings > Data > Imports & exports > Export data and select New data export.

2. Select Data API version and Output format for your exported Conversations data and toggle whether you want to Include attachments.

3. Configure how exported files should be organized:

  • Enter a Folder name (optional).

  • Selecting Export data dated folders will export conversations data into folders named 2025-07-13, 2025-07-14, 2025-07-15 etc.

  • Selecting Skip empty exports when no data has changed will skip any scheduled exports where no data has changed.

4. In the "Destination" section, select AWS S3 or Google Cloud Storage bucket details to receive the exported data.

5. Once your bucket is configured, click the Test button to test that Intercom can write data to your bucket. If successful, a notification will show "Your bucket was successfully tested".

During the test process, a file named intercom-data-export-test-file.json will be written to the root of your bucket.

Note:

  • Intercom can only write to your bucket, it cannot read or delete files.

  • You can't export multiple workspaces to the same bucket.

6. In the "Schedule" section, if you want a full historical data export from the last two years, enable Export historical data for the last two years. Then select the preferred schedule data export frequency, either Hourly or Daily.

7. Scroll to the bottom of the data export page and click Start data export.

8. You will see a notification that a Verification email will be sent to you. This is a security measure to ensure that you are an Intercom Administrator with permission to access your Data export feature. Click OK and then the verification email sent page will be displayed.

9. Navigate to your email client, to find the email from team@intercom.io and click Confirm.

10. The data export will start, with the Historical data export appearing in the table with the Status of In progress.

11. If you want to check your data export configuration settings you can select the Configuration tab to see this.

You can update the following settings after the initial setup:

  • Data API version

  • Output format

  • Attachments

Other settings are read-only. To change the read-only settings you need to delete the data export by clicking the Delete button, and then recreate it.

12. Navigate back to your bucket folder and you will see JSON or JSONL files appearing, in day dated folders if you selected that option in Step 3. Each JSON file will contain JSON formatted Conversation data. The filenames use a date time format in UTC, beginning with the start and end date times for each batch. Each batch will create a separate file in the configured bucket with maximum 200 conversations.

13. Navigate back to Settings > Data > Imports & exports > Export data. When the historical data export is Completed, the periodic data export will begin with the Hourly or Daily frequency selected. All subsequent data exports will appear in the table with the status of In progress and remain when the status is Completed.

14. For Periodic data exports, each file will contain all new and updated conversations for that period, with each JSON object containing the entire conversation with all parts, not a delta from the previous export.

15. If any Attachments are exported they will appear in a folder named as follows and are referenced from the JSON or JSON Lines exported conversations data.

<folder_name>/attachments/<conversation_id>/<conversation_part_id>/<attachment_name>

16. You can delete a data export by clicking the Delete button. This will remove the export configuration but won't delete any files already exported to the destination bucket.


💡Tip

Need more help? Get support from our Community Forum
Find answers and get help from Intercom Support and Community Experts


Did this answer your question?