{"uid":"cap_VU7HmvXaaXPfPnTnSRIGg","slug":"zerion-api-update-tx-subscription-callback-url-617d7bf4","name":"Zerion API - Update TX Subscription Callback URL","description":"Interpreted wallet data for more than 40 chains and Solana: portfolios, DeFi positions, PnL, transactions and NFTs. REST for apps, x402 pay-per-call for agents.","url":"https://api.zerion.io/v1/tx-subscriptions/%7Bsubscription_id%7D/callback_url?utm_source=zero.xyz","method":"PATCH","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method","bodyType","body"],"properties":{"body":{"required":["subscription_id","callback_url"],"properties":{"callback_url":{"type":"string","description":"New webhook URL"},"subscription_id":{"type":"string","description":"Subscription ID"}}},"type":{"type":"string","const":"http"},"method":{"enum":["PATCH"],"type":"string"},"bodyType":{"enum":["json","form-data","text"],"type":"string"}},"additionalProperties":false}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"registry","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_qFAGkDemBhUhxCf7tQ0TV","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Updates the callback URL for an existing blockchain transaction subscription by subscription ID","exampleAgentPrompt":"Update my Zerion transaction subscription (ID: sub_abc123) to send callbacks to my new webhook at https://myapp.com/webhooks/txn instead of the old URL.","exampleUseCases":[{"title":"Redirect webhook after server migration","prompt":"My backend just moved to a new server — update the callback URL on Zerion subscription sub_xyz789 to https://new-server.myapp.com/callbacks/transactions."},{"title":"Fix broken transaction notification endpoint","prompt":"The webhook URL on my transaction subscription sub_def456 is returning 404s — change the callback URL to https://api.myapp.io/v2/zerion-hooks so alerts start flowing again."},{"title":"Switch tx alerts to staging environment","prompt":"I want to reroute my Zerion tx subscription sub_stg999 callbacks to https://staging.myapp.com/tx-events while I test my new transaction handler."}],"resultDescription":"Returns the updated transaction subscription object confirming the new callback URL has been saved, including the subscription ID and updated callback_url field.","failureModes":["subscription_id not found — 404 if the subscription does not exist or belongs to a different account","invalid callback URL format — 400 if the URL is malformed or not HTTPS","unauthorized — 401 if API key is missing or invalid","payment required — 402 if x402 payment is not provided or USDC balance insufficient","rate limiting — 429 if too many requests in a short window"],"whenToPreferThis":"Use this endpoint when you have an existing Zerion transaction subscription and need to change where notifications are delivered — such as after a server migration, endpoint refactor, or environment switch. Prefer this over deleting and recreating the subscription to preserve the subscription ID and avoid missing any in-flight notifications.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-21T12:44:49.142Z","isFirstParty":false,"canonicalSlug":"zerion-api-update-tx-subscription-callback-url-617d7bf4"}