Creator payouts from Grade, with ROI per creator and post
Paste a read-only Grade key once. Every hour Sumly reads the payouts you sent creators through Grade into Costs, Grade's fee as its own line, and sets each creator and each post against the visitors and payments they brought.
Three steps
Read-only in what Sumly does: it never sends a payout, approves one or changes a campaign.
-
1
In Grade, open Developer › Applications › New application and make a key with Payouts and Campaigns set to Read only. Allowed origins can stay empty: Sumly reads from its server.
-
2
On Costs › Grade, paste the application id and the key, and pick the project the costs are for (or all projects). Sumly checks the key with a read and says which scope is missing, if one is.
-
3
Give each creator a ref link of their own, such as
?ref=maya, and for a post of its own add the post's id asutm_content.
Or let your coding assistant do it
Paste this into Claude Code, Cursor or Codex in your project. It fits the code to how your project is built, asks you for the dashboard steps and leaves the keys to you.
See what it says
Set up Grade for Sumly in this project. Sumly (https://sumly.dev) shows revenue next to the visits and app users it came from. The full guide is https://sumly.dev/integrations/grade; read it if anything below is unclear. Steps: 1. In Grade, open Developer › Applications › New application and make a key with Payouts and Campaigns set to Read only. Allowed origins can stay empty: Sumly reads from its server. 2. On Costs › Grade, paste the application id and the key, and pick the project the costs are for (or all projects). Sumly checks the key with a read and says which scope is missing, if one is. 3. Give each creator a ref link of their own, such as `?ref=maya`, and for a post of its own add the post's id as `utm_content`. So each payment shows which visit it came from: A creator's payouts count on ROI for the ref link the visits carry that matches the creator's name, the start of their e-mail or their @handle. A post counts the visitors that came from its own link or carry its id as utm_content. Keep in mind: A creator meets their visitors only through a ref link whose letters match their name in Grade, the start of their e-mail or their @handle on a post. TikTok and Instagram send no referrer, so a post meets its visitors only when its link carries the post's id as utm_content. A fee shown in another currency than the payout stays inside the creator's line. Without campaigns:read the costs come without campaign or creator names, and creators cannot be matched to ref links. How to work: - Look at how this project is built first, and fit the code to its framework and its way of doing things; the examples above are a starting point, not something to paste as is. - Steps that happen in a dashboard (Sumly, or Grade's own) are mine: tell me exactly what to click, then wait for me. - Keys the code needs belong in environment variables, never in the code or the repository. Never ask me to paste a secret key into this chat; tell me which variable to set. - Change only what this needs, show me the changes before you commit, and tell me how to check that it works.
What you see after connecting
Grade next to every other project and provider, on the same pages.
Costs › Grade
Each creator and each post, what they were paid and what the people they brought paid.
Costs
The payouts and fees, one line per creator and campaign.
ROI by ref link
Each creator next to every other channel.
Which creator and post brought them
A creator's payouts count on ROI for the ref link the visits carry that matches the creator's name, the start of their e-mail or their @handle. A post counts the visitors that came from its own link or carry its id as utm_content.
How attribution works →Counts toward your plan
Nothing: costs never count toward your plan. Plans →
What you don't get
No payouts sent from Sumly and no approvals: Grade stays where you pay creators.
The details
What is read
- Each creator payout: amount, currency, status and the day it was paid
- Grade's fee on each payout
- Campaign names and each creator's name in Grade
- Each creator's posts from their payout report: link, platform, views and what was paid
When
- Every hour, what changed in Grade's payout feed since the last read. Grade sends no notice when a payout changes, so Sumly asks.
- The first read goes back as far as Grade keeps payouts.
- Each payout is one cost for what the creator got and one for Grade's fee, known by Grade's own id: read again it is updated, never added twice.
- A payout that failed, was reversed, cancelled or refunded leaves Costs.
- Costs stay in the payout's currency (USD, EUR, GBP or CAD) and turn into euros at the European Central Bank's rate of each day.
Good to know
- A creator meets their visitors only through a ref link whose letters match their name in Grade, the start of their e-mail or their @handle on a post.
- TikTok and Instagram send no referrer, so a post meets its visitors only when its link carries the post's id as utm_content.
- A fee shown in another currency than the payout stays inside the creator's line.
- Without campaigns:read the costs come without campaign or creator names, and creators cannot be matched to ref links.
Grade questions
Does Sumly send or approve payouts?
No. It uses read scopes only. A key with Payouts and Campaigns on Read only is all it needs.
Why does a creator show no visitors?
No visit carries a ref link that matches them yet. Give them a link such as ?ref= with their name or handle, and their payouts meet the people it brings.
Does Grade's fee count?
Yes, as its own cost line next to the creator's, so ROI counts what you paid in all.
What happens to a payout that is reversed?
Its costs leave Costs on the next read, within the hour.
Other integrations
Shopify
Cloudflare
Bunny
Vercel
Your own server
Try it with your own projects
Sign in with Google or a code by e-mail and connect your first project. The first 14 days of a paid plan are free, with no card.
Start free trialOr look around first: open the live demo.