Amazon S3 integration

The Amazon S3 integration lets you import 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

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

Opportunities

Import opportunities from other systems in bulk.

Required fields: unique identifier, title

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

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

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.
  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.

Schema documentation:

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.