Události webhooků

Formulář webhooku ukazuje názvy událostí. Do endpointu přijde každá jako POST s tělem JSON a se svým kódem v eventType i v hlavičce Tiklify-Event.

Kdy která přijde

• „Změna stavu kampaně“ campaign.status_changed — kampaň změnila stav na jedné platformě: zveřejnění, naplánování, pozastavení, obnovení, zastavení, konec nebo zrušení.
• „Konec kampaně“ campaign.ended — skončila celá kampaň.
• „Nové video“ submission.created — přijali jsme video tvůrce.
• „Video splnilo cíl“ submission.goal_reached — video v kampani typu Cíl dosáhlo požadovaných zhlédnutí.
• „Video čeká na schválení“ submission.pending_approval — video čeká na vaše rozhodnutí, včetně videí uvolněných z pořadníku nebo po kontrole.
• „Video schváleno“ submission.approved — video jste schválili vy, schválilo se automaticky, nebo po rozhodnutí sporu.
• „Video zamítnuto“ submission.rejected — video zamítli vy, nebo naše kontrola.
• „Video vypršelo“ submission.expired — kampaň nebo doba výdělku skončila dřív, než video získalo odměnu.
• „Odvolání podáno“ submission.dispute_opened — u videa začal spor, třeba odvolání tvůrce.
• „Odvolání rozhodnuto“ submission.dispute_resolved — spor je rozhodnutý.

Tlačítko „Test“ pošle událost test.

Pole

Pole těla jsou níže. Hlavička Tiklify-Event-Id nese stejnou hodnotu jako eventId. Osobní údaje tvůrců tělo nenese.

každá událost                 schemaVersion (nyní 2), eventId, eventType, occurredAt (ISO 8601, UTC), campaignId

campaign.status_changed       target (id, platform, contentKind), from, to
campaign.ended                reason: ended | cancelled | mixed (část platforem skončila, část byla zrušena)
submission.created            submission
submission.goal_reached       submission, views
submission.pending_approval   submission, approveUntil (čas automatického schválení, nebo null,
                              když musí rozhodnout člověk)
submission.approved           submission, rewardAmount (text: u Cíle pevná odměna, u Za zhlédnutí
                              částka za zhlédnutí videa), currency, automatic (true | false)
submission.rejected           submission, appealUntil (lhůta pro odvolání, nebo null)
submission.expired            submission
submission.dispute_opened     submission, disputeId
submission.dispute_resolved   submission, disputeId, outcome: creator | brand
test                          test: true, ranAt (bez campaignId)

submission    id, targetId (kampaň na jedné platformě), platform, videoUrl (adresa, nebo null)
from, to      draft | scheduled | live | paused | stopped | ended | cancelled | archived
platform      tiktok | instagram | youtube
contentKind   video (tiktok) | reel (instagram) | short (youtube)
currency      EUR | CZK | PLN

Ukázka těla

{
  "schemaVersion": 2,
  "eventId": "3ed902c6-ce55-42d9-84f6-39c5de0e7435",
  "eventType": "submission.approved",
  "occurredAt": "2026-10-16T09:30:00.000Z",
  "campaignId": "31999db1-6be4-4cce-81cc-aee51f5e8efb",
  "submission": {
    "id": "cf2b7a29-fa3c-42e9-9414-9b3db1dd07b1",
    "targetId": "67c4fe02-65e3-4621-a742-994e863d04c7",
    "platform": "tiktok",
    "videoUrl": "https://www.tiktok.com/@creator/video/7426512345678901234"
  },
  "rewardAmount": "1500.00",
  "currency": "CZK",
  "automatic": false
}

Opakování a duplicity

Bez odpovědi 2xx do 10 sekund doručení opakujeme: celkem nejvýše 5 pokusů s rostoucím odstupem od 30 sekund. Událost tak může přijít dvakrát, nebo až po novější: ukládejte eventId, známou událost jen potvrďte kódem 2xx a pořadí určujte podle occurredAt.

Nepomohlo? Napište nám na hello@tiklify.com.