Skip to content

Participants

A participant is a creator who joined your offer.

Status Meaning
pending Joined and waiting for a code from you
active Has a code and a link; can receive accruals
rejected Declined by you; the creator sees your reason
Terminal window
curl -s "https://suly.gg/api/partner/v1/participants?status=pending&page=1" \
-H "Authorization: Bearer $SULY_KEY"

status is pending, active, rejected or all (the default). 50 per page, newest first.

{
"participants": [
{
"participantId": "…",
"status": "pending",
"creator": { "userId": "…", "name": "Andry" },
"channels": [
{
"platform": "youtube",
"name": "Andry Plays",
"handle": "UC…",
"url": "https://www.youtube.com/channel/UC…",
"views": 120000,
"periodDays": 28,
"countries": [{ "country": "RU", "share": 41.5 }]
}
],
"code": null,
"link": null,
"rejectReason": null,
"info": null,
"joinedAt": "2026-11-03T10:00:00.000Z",
"updatedAt": "2026-11-03T10:00:00.000Z",
"accrued": "0.000000"
}
],
"total": 1,
"page": 1,
"pageSize": 50
}
Field Meaning
participantId Stable id of this creator in your offer. Use it as the key in your system
creator The creator’s name on suly.gg
channels The creator’s verified channels. views and periodDays are the channel’s views for the last 28 or 30 days, or null; countries is the audience share in percent, or an empty list
code, link What you gave the creator, or null
rejectReason Your reason if you declined, or null
info Your note to the creator: { "text", "updatedAt" }, or null
accrued How much this creator has already been paid in this offer

One participant in the same form.

Give a creator a code and a link, or replace them at any time.

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"}'
Field Rules
code 1–100 characters
link An https:// address, up to 1,000 characters

The answer is the participant, now active. The creator sees the new code and link at once. A code sent to a declined creator makes them a participant again.

Decline a creator with a reason they will see.

Terminal window
curl -s https://suly.gg/api/partner/v1/participants/$ID/reject \
-H "Authorization: Bearer $SULY_KEY" \
-H 'Content-Type: application/json' \
-d '{"reason":"The audience does not fit"}'

reason is 1–500 characters. The answer is the participant, now rejected. Declining never touches money that was already accrued.