# Spraay Gateway Webhook Registration

> Spraay Gateway Webhook Registration is a paid API for AI agents from gateway.spraay.app, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-14).

Registers a webhook URL to receive real-time notifications for payment, escrow, and swap events on the Spraay gateway.

## Facts

- Endpoint: POST https://gateway.spraay.app/api/v1/webhook/register
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/spraay-gateway-webhook-registration-16840f0f
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_jW3OzeOdx7Q3nEDz2oMFl

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 spraay-gateway-webhook-registration-16840f0f -d '<json body>'
```

Example prompt: Register my server at https://myapp.example.com/webhooks/spraay to receive payment and escrow events from the Spraay gateway so I get notified whenever a transaction completes or an escrow changes state.

## When to prefer this

Use this endpoint when you need event-driven, real-time notifications for payment, escrow, or swap activity on the Spraay gateway specifically. Prefer this over polling sibling endpoints when low-latency reaction to transaction state changes is required, or when building automated workflows that must respond immediately to crypto payment or DeFi swap completions.

## Known failure modes

- Invalid or unreachable webhook URL returns a 4xx error
- Unsupported event type in the events array causes validation failure
- Duplicate registration for same URL and events may return conflict or silently succeed
- Missing required fields (url or events) results in a 400 Bad Request
- Payment failure (insufficient USDC) blocks the registration from completing

## How this service works

Register webhook for payment/escrow/swap events.

## Output

A confirmation of the webhook registration, including a subscription or registration ID and the list of event types now being monitored. Future events matching the registered types will trigger HTTP POST callbacks to the provided URL.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "url": {
   "type": "string"
  },
  "events": {
   "type": "array"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/spraay-gateway-webhook-registration-16840f0f/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from gateway.spraay.app](https://www.zero.xyz/host/gateway.spraay.app/llms.txt)