tip.held
A tip was parked in the manual review queue instead of entering the TTS / media queues. reason says why (manual = the streamer reviews everything, filter = the word/AI filter matched and the streamer chose review over silent replace/block, ai_unavailable = the AI filter could not be reached, media_lookalike = the tip’s video looks like a banned one, usually a reupload). payment_state says where the money is meanwhile: captured (charged), held (Stripe auth only - approval captures, rejection releases) or none (nothing was paid, e.g. a sub-reward message).
tip.heldWebhookapplication/jsonidstringrequiredUnique event id.
typeanyrequiredcreatedstring<date-time>requiredactorobject | nullrequiredWho caused the event. null for system-originated events (a
payment landing, an overlay heartbeat lapsing). Otherwise one of
user (a team member in the dashboard), chat (a moderator's
chat command via the bot), api_key (a developer API key), oauth_app (an OAuth-connected app),
overlay (the overlay reporting start/finish) or bot.
Show propertiesHide properties
nulltypestringrequireduserchatapi_keyoauth_appoverlaybotuser_idstring | nullTipPage user id (u_...). Always set for user actors; set for chat actors when the chatter's account is linked to a TipPage user.
platformstring | nulluser / chat actors - the platform account behind the actor
twitchkicknullplatform_idstring | nulluser / chat actors - the account's id on that platform
loginstring | nulluser / chat actors
display_namestring | nulluser / chat actors
idstring | nullapi_key (ak_...) / oauth_app (oc_..., the client id) / overlay (o_..., the overlay id) actors
namestring | nullapi_key / oauth_app / overlay actors
authorization_idstring | nulloauth_app actors only - the authorization (oa_...) the app acts under
dataobjectrequiredShow propertiesHide properties
order_idstringnamestring | nullamountnumber | nullcurrencystring | nullmessagestring | nullThe message as the donor typed it.
has_mediabooleanreasonstringmanualfilterai_unavailablemedia_lookalikepayment_statestringcapturedheldnonesourcestringReturn any 2xx quickly.