> ## Documentation Index
> Fetch the complete documentation index at: https://docs.chartcastr.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Amplitude source

> Connect Amplitude to Chartcastr for automated DAU/WAU/MAU, top events, funnels, retention, and UTM source/medium/campaign breakdowns delivered to Slack or email.

## Overview

Use Amplitude as a data source for Chartcastr. Connect your project with an **API Key + Secret Key** and Chartcastr will pull active user metrics, top events, funnel conversion, cohort retention, custom event overlays, and **UTM-broken-down traffic** to generate charts delivered automatically to Slack or email.

Chartcastr connects with read-only access via Amplitude's Dashboard REST API — no SDK changes, no data export required.

## Setup

<Steps>
  <Step title="Find your Amplitude API Key + Secret Key">
    In Amplitude, open **Settings → Organization Settings → API and Secret Keys**. The **API Keys** tab lists each project's key — copy the key value for the project you want to chart.

    <Frame>
      <img src="https://mintlify.s3.us-west-1.amazonaws.com/chartcastr/images/integrations/sources/amplitude/api-keys.png" alt="Amplitude Organization Settings showing the API and Secret Keys page with the API Keys tab selected and a list of project API keys" />
    </Frame>

    Switch to the **Secret Keys** tab and click **Show** to reveal the matching secret for the same project.

    <Frame>
      <img src="https://mintlify.s3.us-west-1.amazonaws.com/chartcastr/images/integrations/sources/amplitude/secret-keys.png" alt="Amplitude API and Secret Keys page with the Secret Keys tab selected, showing a Show button to reveal the project's secret key" />
    </Frame>

    <Warning>
      Anyone with the Secret Key can query your project's data. Chartcastr stores it encrypted at rest with AES-256-GCM, but treat the key as a credential and rotate it through Amplitude if it ever leaks.
    </Warning>
  </Step>

  <Step title="Connect in Chartcastr">
    In Chartcastr, go to **New Connection** and select **Amplitude** as a source. Pick **US** or **EU** region, paste the API Key + Secret Key, and click **Test & Connect**.

    <Info>
      **Region**: Use **US** for `amplitude.com` or **EU** for `analytics.eu.amplitude.com`. The region drives which API host we hit and is locked once connected — disconnect and reconnect to switch regions.
    </Info>
  </Step>

  <Step title="Confirm your pageview event">
    After connecting, Chartcastr auto-detects your pageview event by looking for common names (`[Amplitude] Page Viewed`, `Page Viewed`, `pageview`, etc.) in your top events. You can override it with any event from your project — pick **Pick a different event** in the connect modal.
  </Step>

  <Step title="Select a metric">
    Choose a chart type. Funnel metrics ask you to pick an ordered 2–5 event sequence; the Custom Events Overlay asks you to pick up to 5 events; the **UTM Traffic** and **UTM Conversion** charts ask you to pick a UTM dimension (`utm_source`, `utm_medium`, `utm_campaign`, `utm_content`, `utm_term`) and 1–5 specific values to overlay as separate lines.
  </Step>

  <Step title="Create a connection">
    Pick or add a destination (Slack channel or email), set the delivery frequency, and optionally enable AI summaries.
  </Step>
</Steps>

## Available Metrics

Chartcastr supports **15 pre-built Amplitude metrics** across seven categories.

<CardGroup cols={2}>
  <Card title="Active Users" icon="users">
    DAU, WAU, MAU, new users, and a combined DAU/WAU/MAU chart for engagement tracking.
  </Card>

  <Card title="Events" icon="bolt">
    Total events, unique event users, and a stacked Top Events chart.
  </Card>

  <Card title="Pageviews" icon="eye">
    Total pageviews and unique pageview users using your auto-detected pageview event.
  </Card>

  <Card title="Funnels" icon="filter">
    Overall conversion rate and per-step user counts for an inline 2–5 event funnel.
  </Card>

  <Card title="Retention" icon="repeat">
    Average weekly cohort retention curve based on returning user activity.
  </Card>

  <Card title="Custom Events Overlay" icon="layers">
    Pick up to 5 events and overlay them as lines on a single chart.
  </Card>

  <Card title="UTM Traffic & Conversion" icon="chart-line">
    Pick a UTM dimension and 1–5 specific values; we render each value as its own line on a single chart so you can compare Google vs Reddit vs Twitter (or any campaigns) at a glance.
  </Card>
</CardGroup>

<Card title="View all available charts" icon="list" href="/integrations/sources/amplitude/available-charts">
  See the full list of Amplitude metrics with chart types and descriptions.
</Card>

## UTM Breakdowns

Amplitude's JS SDK automatically captures `utm_source`, `utm_medium`, `utm_campaign`, `utm_content`, and `utm_term` as event properties on every event. The **UTM Traffic** and **UTM Conversion** charts let you pick one of those dimensions and overlay up to **5 specific values** as separate lines.

* **UTM Traffic** — counts pageview events per UTM value (e.g. pageviews from `utm_source=google` vs `utm_source=reddit`).
* **UTM Conversion** — counts a chosen conversion event (e.g. `Sign Up`) per UTM value, so you can compare conversion volume across campaigns.

Pick a value list with care: with 5 lines on one chart the hard cap is what keeps it readable in a Slack post. We pull the top-50 most-frequent values per dimension so you can find rare campaigns via the search box.

## Authentication

Chartcastr uses HTTP Basic auth with your Amplitude API Key + Secret Key. The secret is encrypted at rest with AES-256-GCM. We never store project-token-style credentials — only the API key pair, which is scoped to a single Amplitude project and is read-only at the Dashboard REST API level.

## Rate Limits

Amplitude's Dashboard REST API is capped at **360 requests/hour** per project with a maximum of **6 concurrent queries**. Chartcastr's pulse cadence (daily/weekly) keeps you well below the cap. If you hit the limit you'll see a clear "rate limit hit" error in the chart preview — wait an hour and try again.

## Next Steps

<CardGroup cols={2}>
  <Card title="Slack destination" icon="slack" href="/integrations/destinations/slack">
    Deliver Amplitude charts to your Slack channels with AI summaries in the thread.
  </Card>

  <Card title="Email destination" icon="envelope" href="/integrations/destinations/email">
    Send pulse charts to a distribution list on the cadence that fits your team.
  </Card>
</CardGroup>