{"uid":"cap_L_wTtl-ZdTmMvKLBPMxBB","slug":"subscription-renewal-reminder-registration-fc0478f8","name":"Subscription Renewal Reminder Registration","description":"Register a subscription (yours or one you manage for another agent) for renewal-reminder tracking. Bookkeeping only — no auto-renewal, no custody, this server never pays on your behalf. Fires a webhook once per cycle when the reminder window opens.","url":"https://lab.paidapis.net/api/subscriptions/register","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"amountUsdc":{"type":"number","description":"Renewal amount, in USDC."},"serviceUrl":{"type":"string","description":"URL of the subscribed service."},"webhookUrl":{"type":"string","description":"Public http(s) URL to POST a reminder to before renewal is due."},"serviceName":{"type":"string","description":"Display name of the subscribed service (max 80 chars)."},"ownerAddress":{"type":"string","description":"Wallet address this subscription belongs to."},"nextRenewalAt":{"type":"string","description":"ISO 8601 date of the next renewal (default: now + renewsEverySeconds)."},"renewsEverySeconds":{"type":"integer","description":"Renewal period length, in seconds."},"reminderLeadSeconds":{"type":"integer","description":"Seconds before nextRenewalAt to fire the reminder, up to 2592000 (default 60)."}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","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_oGw1uFo1vzTNOwbRy6oWe","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Registers a subscription for renewal-reminder tracking and fires a webhook when the reminder window opens before the next renewal date.","exampleAgentPrompt":"Register a renewal reminder for my Notion Pro subscription (https://notion.so) that renews on 2025-09-01 for $16 USDC every 30 days — alert my webhook at https://myagent.example.com/hooks/renewal at least 3 days (259200 seconds) before it's due, and tag it to my wallet 0xAbC123...","exampleUseCases":[{"title":"SaaS renewal alert for solo dev","prompt":"Set up a renewal reminder for my GitHub Copilot subscription at https://github.com/features/copilot — it renews on 2025-08-15 for 10 USDC every 30 days, and I want my webhook at https://myapp.dev/hooks/copilot-renewal pinged 2 days (172800 seconds) before the due date. Owner wallet is 0xDead...Beef."},{"title":"Agent managing subscriptions for clients","prompt":"I'm managing subscriptions on behalf of a client — register their Figma Pro plan at https://figma.com/pricing for 45 USDC, renewing every 365 days from 2025-10-01, and fire a reminder to https://agent.myplatform.io/renewal-hook 7 days (604800 seconds) before it's due. Associate it with their wallet 0x1234...5678."},{"title":"Reminder for crypto tool subscription","prompt":"Track the renewal for my Dune Analytics subscription (https://dune.com) — it costs 50 USDC and renews monthly starting 2025-07-20. Send a reminder to https://hooks.mydomain.com/dune-alert 48 hours (172800 seconds) before renewal, linked to wallet 0xFeed...Cafe."}],"resultDescription":"Returns a confirmation that the subscription has been registered for tracking, including the assigned subscription ID, the scheduled reminder timestamp, and the configured webhook URL that will be called when the reminder window opens. No payment is initiated — the endpoint only bookmarks the renewal cycle and queues the webhook trigger.","failureModes":["Invalid or unreachable webhookUrl — reminder cannot be delivered","Invalid ISO 8601 format for nextRenewalAt — returns 400 bad request","reminderLeadSeconds exceeds maximum of 2592000 — capped or rejected","Missing required fields (serviceUrl, webhookUrl, renewsEverySeconds) — returns 400","Invalid or malformed ownerAddress wallet — registration rejected","Payment of 0.01 USDC not supplied via x402 — returns 402 Payment Required"],"whenToPreferThis":"Use this endpoint when you need lightweight, bookkeeping-only renewal tracking for subscriptions without any auto-payment or custody risk. It is ideal for AI agents managing subscriptions on behalf of users or other agents, where the goal is simply to receive a webhook reminder before renewal so the agent can take its own action. Prefer this over full subscription management platforms when you only need the notification layer and want to keep payment logic entirely in your own control.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T12:31:01.987Z","isFirstParty":false}