Amplitude
What Paperbeam reads from Amplitude, the read-only access it asks for and why, filters, and the beats it feeds.
Product analytics
Read-only API key
Event counts, daily active and new users, retention and saved chart values from Amplitude, each compared with the previous period.
What we read
- Metric values
Only the reporting window of each edition is read. Paperbeam stores derived facts and short excerpts, not copies of your Amplitude data, and keeps raw evidence only for your retention period.
Access we ask for, and why
| Scope | Why |
|---|---|
Project API key + secret key (Dashboard REST API, read-only) | Query event counts, active users, retention and saved charts |
All access is read-only. You can revoke it from Amplitude at any time, or disconnect the source in Paperbeam.
Connect Amplitude
- Go to Sources and choose Amplitude.
- Create a api key and secret key. Amplitude → Settings → Organization settings → Projects → (your project) → General: copy the API key and secret key. Open Amplitude settings.
- Fill in API key, Secret key, Data region (optional) and Organization URL name (optional), then click Test connection. Paperbeam makes one read-only call and shows the account it reached, or exactly what went wrong.
- Click Connect. The credential is encrypted before it is stored and never shown again. Use Sync now on the source’s page to see what it collects from the last 24 hours, and set filters there.
You need the admin or owner role in Paperbeam, and enough permission in Amplitude to grant read access to the data listed above.
Filters
Set on the source’s page at Sources›Amplitude. Filtered-out data is never collected.
| Filter | Effect |
|---|---|
| Organization URL name | Optional. The part after /analytics/ in your Amplitude URL, used to link straight to charts. |
To keep specific people, channels or topics out of the paper across all sources, use exclusion rules and the never-mention list in House style.
Beats
Amplitude is a source for:
Stories land in whichever of your sections fits them best.