Create a command
name is the trigger without the ! prefix; the bot’s built-in triggers are reserved. Responses support the same template variables as the dashboard’s Chat bot page - {user}, {touser}, {args}, {arg:N}, {pick:a|b|c}, {random:1-100}, {list:name}, {if:...}, {repeat:N|...}, {uptime}, {ai:...} and more, and variables nest (full reference: https://docs.tippage.com/chat-bot/variables). Response lists themselves are managed in the dashboard. A streamer can have at most 250 commands. Requires commands:manage.
/commandsAuthorizationBearer token (tp_live_... or tpat_...) · headerrequiredA TipPage API key (tp_live_..., created in Dashboard → Settings → Developer) or an OAuth 2.0 access token (tpat_..., see the OAuth guide). Both carry the same scopes and are accepted on every endpoint.
application/jsonnamestringrequiredThe trigger without the ! prefix - lowercase letters, numbers, hyphens, and underscores. The bot's built-in triggers are reserved.
responsestringrequiredThe template. Can't start with / or !. Its fixed wording (everything outside {variables}) must fit in one 500-character chat message; the rendered chat line is cut to 500.
descriptionstring | nullViewer-facing blurb for the tip page's command list. Plain text.
listedbooleanai_memorybooleanai_memory_sharedbooleanplatformsstring[]Which chat(s) the command answers in. At least one.
permissionstringeveryonesubscribermoderatorcooldown_secondsintegercooldown_typestringglobalper_useraliasesstring[]Same lexical rules as name; max 10.
enabledbooleanCreated. Active in chat within a few seconds.
commandCustomCommandShow propertiesHide properties
namestringThe trigger, without the ! prefix.
responsestringWhat the bot answers. Template variables supported.
descriptionstring | nullOptional viewer-facing blurb shown on the tip page's command list instead of the response. null = the page shows a preview of the response with variables rendered as labels ({urlfetch:} addresses and {ai:} prompts are never shown).
listedbooleanWhether the command appears on the tip page's command list. It works in chat either way.
ai_memoryboolean{ai:} conversation memory - when true the character remembers this command's last 15 exchanges (with timestamps, kept until the command is deleted) and reacts to repeats and returning viewers. Only meaningful for responses containing {ai:}. Memory is per platform unless ai_memory_shared.
ai_memory_sharedbooleanOne memory for Twitch and Kick instead of one per platform. Only meaningful with ai_memory.
platformsstring[]Which chat(s) it runs in. Default both. A platform the streamer hasn't connected is simply skipped; the set can't be empty (use enabled: false to bench it).
permissionstringWho can trigger it. subscriber includes moderators; moderator includes the streamer.
everyonesubscribermoderatorcooldown_secondsintegercooldown_typestringglobal = one shared cooldown for the whole channel; per_user = each viewer gets their own.
globalper_useraliasesstring[]Extra triggers for the same command, also without the !.
enabledbooleancreated_atstring<date-time>updated_atstring<date-time>Invalid fields (invalid_command), or the streamer already has 250 commands (limit_reached).
errorstringrequiredHuman-readable message.
codestringMachine-readable code (e.g. missing_scope, not_in_queue).
Missing or invalid credential (missing_api_key / invalid_api_key, or invalid_token for an expired/revoked OAuth access token).
errorstringrequiredHuman-readable message.
codestringMachine-readable code (e.g. missing_scope, not_in_queue).
The key lacks the required scope (missing_scope).
errorstringrequiredHuman-readable message.
codestringMachine-readable code (e.g. missing_scope, not_in_queue).
required_scopestringName already taken (command_exists), or an alias collides with another trigger (alias_in_use).
errorstringrequiredHuman-readable message.
codestringMachine-readable code (e.g. missing_scope, not_in_queue).
Rate limit exceeded - check the RateLimit-* headers.
errorstring