Skip to content
CLIUnofficial

privy webhooks watchlist update

Replace the app funding-webhook asset watchlist, independently of subscriptions.

Usage

Section titled “Usage”
Terminal window
privy webhooks watchlist update [options]

Options

Section titled “Options”
Option Description
--dry-run Validate and print the API request without network access or credentials.
--yes Confirm this mutation or export.
--body <json> JSON body, or - to read stdin.
--file <path> JSON body file, or - to read stdin.
--assets <json> Complete array of {caip2,contractAddress}; null means native asset. [] clears explicit watches. CLI bound: 1,000 entries. HTTP body is the array itself.
--diff Read live state and show changes WITHOUT writing (requires login).
--allow-production Explicitly allow this production mutation; also requires --yes.

Global options such as --app, --account and --profile also apply. See the command reference overview.

Examples

Section titled “Examples”
Terminal window
privy webhooks watchlist update --assets "[]" --diff
privy webhooks watchlist update --body '[{"caip2":"eip155:11155111","contractAddress":null}]' --dry-run

Behavior

Section titled “Behavior”
  • Changes data: yes. Preview with --dry-run, then run with --yes and any required confirmations.
  • Scope: app
  • Before it runs: Check app environment and endpoint state. Delete/test/resend/enable require exact --confirm-url. Subscriptions affect all app endpoints.
  • Production apps: Requires --allow-production and --yes.
  • Verification: List/status read-back for configuration; notification submissions are acknowledgements, not successful delivery.
  • Retries: None.
  • Caution: Callbacks can disclose user data or repeat receiver business actions. Only use authorized destinations.
Section titled “Related guides”

Inspect the full contract locally with privy schema webhooks watchlist update.

Privy CLI is an unofficial, community project by Samarth Saxena. Not affiliated with or endorsed by Privy. The Privy name and wordmark belong to Privy. It uses undocumented dashboard APIs that can change.