# 2s Schedule Create — One-Shot and Recurring Callback Scheduler

> 2s Schedule Create — One-Shot and Recurring Callback Scheduler is a paid API for AI agents from 2s.io, paid per call via x402, $0.125/call, status unknown (last checked 2026-09-15).

Creates a one-shot or recurring scheduled job that POSTs a signed callback to a given URL at a specified time or interval

## Facts

- Endpoint: POST https://2s.io/api/schedule/create
- Price: $0.125/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/2s-schedule-create-one-shot-and-recurring-callback-scheduler-1b2953a7
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_JOwStoa0os1Yigrk06Vm2

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 2s-schedule-create-one-shot-and-recurring-callback-scheduler-1b2953a7 -d '<json body>'
```

Example prompt: Set up a recurring callback to https://myapp.example.com/hooks/digest every 3600 seconds with payload {"job":"daily-digest"}, stop after 30 fires, and label it 'daily-digest-job'.

## When to prefer this

Choose this endpoint when you need a lightweight, pay-per-call, keyless scheduler that delivers signed HTTP callbacks either once at a precise future timestamp or on a recurring interval. It is ideal for AI agent workflows that need timed triggers without maintaining their own cron infrastructure. Prefer it over self-hosted cron or managed job queues when you want zero setup, USDC micropayment billing, and cryptographically signed callbacks for verification.

## Known failure modes

- Providing both 'at' and 'everySeconds' simultaneously returns a validation error
- 'at' timestamp in the past may be rejected
- everySeconds below 60 is rejected as below minimum
- callbackUrl missing or malformed returns a validation error
- maxFires above 1000 is rejected
- expiresInSeconds below 60 is rejected
- Payment failure or insufficient USDC balance prevents schedule creation
- Callback URL unreachable at fire time results in a missed delivery with no retry guarantee

## How this service works

The (most) everything API: 575+ pay-per-call endpoints for AI agents — ground-truth data, a full AI gateway, and agent infrastructure (storage, queues, watchers). USDC via x402, no signup, no API keys, and upto billing: pay actual usage, not the quote.

## Output

Returns an object with ok:true and an items array containing the created schedule's scheduleId, status, nextFire timestamp, everySeconds interval, maxFires limit, expiresAt timestamp, and callbackSigner public key used to verify signed callbacks. Also includes a source object with provider, URL, and license metadata.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "at": {
   "type": "string",
   "description": "ISO-8601 timestamp for a ONE-SHOT fire. e.g. \"2026-07-01T14:00:00Z\". Provide this OR everySeconds, not both."
  },
  "label": {
   "type": "string",
   "maxLength": 64,
   "description": "Optional free-text tag to recognize this schedule later."
  },
  "payload": {
   "type": "object",
   "description": "Arbitrary JSON echoed in every callback (plus scheduleId, fireNumber, firedAt). e.g. {\"job\":\"digest\"}.",
   "additionalProperties": {}
  },
  "maxFires": {
   "type": "integer",
   "maximum": 1000,
   "minimum": 1,
   "description": "Stop after this many fires (recurring only). Default 25, max 1000."
  },
  "callbackUrl": {
   "type": "string",
   "maxLength": 2048,
   "description": "Where we POST when it fires. Any http(s) URL; the JSON body is signed (verify with X-2s-Signature)."
  },
  "everySeconds": {
   "type": "integer",
   "minimum": 60,
   "description": "Recurring interval in seconds (≥60). Provide this OR at."
  },
  "expiresInSeconds": {
   "type": "integer",
   "minimum": 60,
   "description": "Auto-expire the schedule after this long. Default + max 90 days."
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/2s-schedule-create-one-shot-and-recurring-callback-scheduler-1b2953a7/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from 2s.io](https://www.zero.xyz/host/2s.io/llms.txt)