Skip to content

Quick start

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.

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.

Terminal window
export SULY_KEY='suly_…'
Terminal window
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.

Read the creators who are waiting for a code:

Terminal window
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:

Terminal window
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.

When your system has worked out what a creator earned, send an accrual with your own operation number:

Terminal window
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.

  1. Every 5–15 minutes: read pending participants and give each a code and a link (or decline).
  2. On your payout schedule: check the budget with GET /program, then send one accrual per creator.
  3. Daily and after each payout: send each creator a note with what they cannot see on suly.gg.
  4. Reconcile: match GET /accruals with your own payouts by externalId.