create_watch
Register webhook watches for AI model price changes, service status transitions, daily/weekly pricing digests, or leaderboard rank movements. Receive HMAC-signed POST notifications to your callback URL.
Instructions
Register a webhook watch. type selects what to watch: "price" (a model price change), "status" (a service status transition), "digest" (a scheduled daily or weekly pricing summary), or "leaderboard_rank" (a provider crossing an uptime-rank threshold). Costs 1 credit ($0.02) at registration; the watch lives 90 days and each fire is an HMAC-signed POST to callback_url. Needs a TENSORFEED_TOKEN.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| type | Yes | What to watch. | |
| callback_url | Yes | HTTPS URL that receives the HMAC-signed POST when the watch fires. | |
| secret | No | Optional shared secret used to HMAC-sign delivery bodies. | |
| model | No | type=price only. Model name (e.g. "Claude Opus 4.7"). | |
| field | No | type=price only. Which price field to watch. | |
| cadence | No | type=digest only. How often the digest fires. | |
| provider | No | type=status or type=leaderboard_rank only. Provider name or slug (case-insensitive). e.g. anthropic, openai, gemini, bedrock, azure. | |
| op | No | type=price uses lt/gt/changes (lt = below threshold, gt = above, changes = any change). type=status uses becomes/changes (becomes = transitions to a specific value; changes = any transition). type=leaderboard_rank uses drops_below/rises_above/changes (rank 1 = best; drops_below: was rank<=N now rank>N; rises_above: was rank>=N now rank<N; changes: any rank movement). | |
| threshold | No | type=price (when op is lt or gt) or type=leaderboard_rank (when op is drops_below or rises_above). Integer rank position for leaderboard_rank. | |
| value | No | type=status only. Required when op is becomes. |