Missed London? Beyond the Map goes live online on Dec 8.

Save your spot →

Amazon S3 integration

The Amazon S3 integration lets you import qualitative data such as surveys, interviews and support logs, as well as solutions, insights, opportunities, and metrics into TheyDo from any tool or system — using JSON files uploaded to an S3 bucket.

This is particularly useful for connecting tools that don't have a native TheyDo integration, or for consolidating data from multiple sources into one place.

Before you start

  • The Amazon S3 integration is set up in collaboration with the TheyDo team. To get started, select Contact us on the Amazon S3 card in Settings > Integrations.
  • You need organization admin permission to set up and manage this integration.
  • You'll need involvement from your IT or engineering team to configure the S3 bucket and set up data exports.

What you can import

Solutions

Bring initiatives, features, and improvements from any delivery tool into TheyDo.

Required fields: unique identifier, title

Optional fields: description (Markdown), external links, status, tags, solution type, owner, priority, team

Schema: Solutions schema

Insights

Consolidate research findings from any platform into TheyDo.

Required fields: unique identifier, title

Optional fields: description, empathy score, external source links, owner, insight type and status, tags, weight

Schema: Insights schema

Opportunities

Import opportunities from other systems in bulk.

Required fields: unique identifier, title

Optional fields: description, external links, status, tags, owner, opportunity type, team

Schema: Opportunities schema

Metrics

Bring performance data from any analytics platform into TheyDo.

Required fields: unique identifier, title, metric type (CES, CSAT, NPS, OTHER, or RATIO), unit of measurement, data points

Optional fields: description, owner, target, tags, dimensions for segmentation

Schema: Metrics schema

Qualitative data (for Data Hub)

Bring the voice of the customer into the Data Hub, where it becomes Quotes ready for the TheyDo Agent and AI mining.

  • Surveys and feedback: many responses per file. Each response becomes one or more Quotes. Schemas: survey responses, feedback responses.
  • Interviews: one file per interview, as conversation turns or a single block of text. Schemas: conversation, text.
  • Support logs: one file per ticket, call or support chat, as conversation turns or a single block of text. Schemas: conversation, text.

For formats, field mapping and how each type lands in TheyDo, see Pull in surveys and feedback from Amazon S3.

How the setup works

  1. Contact TheyDo to initiate the integration setup.
  2. TheyDo provides a dedicated S3 bucket configuration and secure IAM role setup.
  3. Your team configures the data export from your source tools into JSON files following TheyDo's schemas (linked in each section above).
  4. Files are uploaded to the S3 bucket — manually, on a schedule, or via automation.
  5. TheyDo validates the files against the schema and ingests the data.

Authentication options

  • IAM Role (recommended): No credential management, temporary credentials, automatic expiration, full audit trails via CloudTrail.
  • Static credentials: Available if compliance requirements mandate it — requires periodic rotation.

Data sync frequency

You control how often data updates:

  • Manual exports (upload files when needed)
  • Scheduled scripts (daily, weekly, monthly)
  • API integrations (automated sync between systems)
  • CI/CD pipelines (event-driven or continuous)

Security and compliance

  • TheyDo uses a dedicated AWS account exclusively for external integrations, fully isolated from production systems.
  • Each customer receives a unique IAM role scoped only to their designated S3 prefix.
  • You retain control over what data is exported, how often, and which fields are included.
  • Compliant with GDPR, SOC2, and enterprise requirements.

Further reading