Quick start
1. Create the offer
Section titled “1. Create the offer”In the business cabinet open Offers → Create offer, choose Revenue share under “How do you pay creators?”, fill in the form and send it to moderation. The budget moves from your balance into the offer. See Revenue-share offer for every field.
2. Create the API key
Section titled “2. Create the API key”Once the offer is approved, open the offer page and create the key in the API key block. The key is shown only once: copy it into your secret store. Each offer has its own key.
export SULY_KEY='suly_…'3. Check the connection
Section titled “3. Check the connection”curl -s https://suly.gg/api/partner/v1/program \ -H "Authorization: Bearer $SULY_KEY"You get the offer with its status, budget and the current fee.
4. Give creators codes
Section titled “4. Give creators codes”Read the creators who are waiting for a code:
curl -s "https://suly.gg/api/partner/v1/participants?status=pending" \ -H "Authorization: Bearer $SULY_KEY"For each one, create a referral code and a link in your system and send them:
curl -s https://suly.gg/api/partner/v1/participants/$ID/code \ -H "Authorization: Bearer $SULY_KEY" \ -H 'Content-Type: application/json' \ -d '{"code":"ANDRY","link":"https://partner.example/r/ANDRY"}'The creator sees the code and the link at once.
5. Pay
Section titled “5. Pay”When your system has worked out what a creator earned, send an accrual with your own operation number:
curl -s https://suly.gg/api/partner/v1/accruals \ -H "Authorization: Bearer $SULY_KEY" \ -H 'Content-Type: application/json' \ -d '{"participantId":"'$ID'","amount":"125.40","externalId":"2026-10-ANDRY","comment":"October 2026"}'Sending the same request again with the same externalId pays nothing twice, so it is safe to repeat after a timeout.
A typical integration
Section titled “A typical integration”- Every 5–15 minutes: read
pendingparticipants and give each a code and a link (or decline). - On your payout schedule: check the budget with
GET /program, then send one accrual per creator. - Daily and after each payout: send each creator a note with what they cannot see on suly.gg.
- Reconcile: match
GET /accrualswith your own payouts byexternalId.