How to use Amazon S3 data in TheyDo

Once your Amazon S3 integration is set up, data from your S3 bucket flows into TheyDo automatically. Here's what you can do with it and how it works once it's live.

Overview

The Amazon S3 integration is a flexible way to bring data from any tool into TheyDo using JSON files. Once your S3 bucket is configured and data is flowing, TheyDo will ingest it into solutions, insights, opportunities, or metrics — making it visible across your journeys.

For setup instructions, see Amazon S3 integration.

What imported data looks like in TheyDo

Data imported via S3 appears in TheyDo just like items created natively:

  • Solutions appear in your Solutions library and can be connected to journey steps.
  • Insights appear in your Insights library and can be linked to journeys and opportunities.
  • Opportunities appear in your Opportunities library and can be prioritized and tracked.
  • Metrics appear in your Metrics Library and can be added to any journey step.

Items imported from S3 maintain a link to their original source (if an external URL is included in the schema), so you can always trace them back to the originating tool.

Working with S3-imported metrics

S3 metrics work the same as any other metric in TheyDo:

  1. Go to a journey and select Add a metric, or open the Metrics Library.
  2. S3-imported metrics will appear as available sources.
  3. Add them to journey steps to visualize performance data alongside your customer journey.

Supported metric types: CSAT, CES, NPS, RATIO, and Other.

Keeping data up to date

Data updates happen based on the sync frequency you've configured — manual, scheduled, or automated. When a new file is uploaded to your S3 bucket:

  1. TheyDo validates it against the schema.
  2. Valid data is ingested and updates the relevant items in TheyDo.
  3. Any errors are reported so your team can fix and re-upload.

Tips

  • If an item already exists in TheyDo (matched by unique identifier), it will be updated rather than duplicated.
  • Work with your data team to define which fields are most valuable to include — not all optional fields are required for the integration to work.
  • You can expand coverage over time by adding new source tools to your S3 export process.

Common questions

Can we import from multiple tools at once? Yes. Many teams import solutions from multiple delivery tools, insights from several research platforms, and metrics from different analytics systems. Each source is independent.

Will this replace our existing project management tools? No. Your existing tools remain the source of truth for execution. TheyDo acts as the strategic layer connecting that work to customer journeys.

What if our tool doesn't export to JSON? Most modern tools support JSON via API. If not, you can export to CSV and convert, or explore other integration options with the TheyDo team.