Shopify
What Paperbeam reads from Shopify, the read-only access it asks for and why, filters, and the beats it feeds.
Billing & finance
Read-only API key
Daily orders, revenue, average order value and new customers from your Shopify store.
What we read
- Metric values
- Deals: stage changes, wins and losses, amounts and owners
Only the reporting window of each edition is read. Paperbeam stores derived facts and short excerpts, not copies of your Shopify data, and keeps raw evidence only for your retention period.
Access we ask for, and why
| Scope | Why |
|---|---|
read_orders | Count orders and sum revenue for the day |
read_customers | Tell new customers from returning ones |
All access is read-only. You can revoke it from Shopify at any time, or disconnect the source in Paperbeam.
Connect Shopify
- Go to Sources and choose Shopify.
- Create a admin api access token. Shopify admin → Settings → Apps and sales channels → Develop apps → Create an app, grant read_orders and read_customers, install, then reveal the Admin API token. Open Shopify settings.
- Fill in Store and Admin API access token, 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 Shopify to grant read access to the data listed above.
Filters
Set on the source’s page at Sources›Shopify. Filtered-out data is never collected.
| Filter | Effect |
|---|---|
| Large order alert | Optional. Report individual orders at or above this amount (store currency). |
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
Shopify is a source for:
Stories land in whichever of your sections fits them best.