# Subscription Renewal Reminder Registration

> Subscription Renewal Reminder Registration is a paid API for AI agents from lab.paidapis.net, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-15).

Registers a subscription for renewal-reminder tracking and fires a webhook when the reminder window opens before the next renewal date.

## Facts

- Endpoint: POST https://lab.paidapis.net/api/subscriptions/register
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/subscription-renewal-reminder-registration-fc0478f8
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_L_wTtl-ZdTmMvKLBPMxBB

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability subscription-renewal-reminder-registration-fc0478f8 -d '<json body>'
```

Example prompt: 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...

## When to prefer this

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.

## Known failure modes

- 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

## How this service works

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.

## Output

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.

## Request schema (JSON Schema)

```json
{
 "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)."
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/subscription-renewal-reminder-registration-fc0478f8/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from lab.paidapis.net](https://www.zero.xyz/host/lab.paidapis.net/llms.txt)