Register a credit-funded webhook

​

Registers (or updates) webhook delivery for this wallet's credit balance — no Builder subscription required. Free to register; each event that actually fires is billed $0.15 at delivery time (see the "Prepaid credits" section above), not at registration. Requires the credit-auth headers; no bearer-key or x402 fallback. Reuses the same API-key table as /api/builder/key, so the returned webhookSecret signs deliveries the same way (x-hoodgrow-signature: sha256=<hex>). See the Webhooks tag for the delivered event schema and signature verification.

Body
required
application/json
  • webhookUrl
    Type: string Format: uri
    required

    HTTPS delivery URL. Validated the same way as /api/builder/key's webhookUrl.

Responses
  • application/json
  • application/json
  • application/json
  • application/json
Request Example for post/api/agent/credits/webhook
curl https://www.hoodgrow.com/api/agent/credits/webhook \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'X-HoodGrow-Credit-Wallet: YOUR_SECRET_TOKEN' \
  --header 'X-HoodGrow-Credit-Timestamp: YOUR_SECRET_TOKEN' \
  --header 'X-HoodGrow-Credit-Signature: YOUR_SECRET_TOKEN' \
  --data '{
  "webhookUrl": ""
}'

{
  "ok": true,
  "webhookUrl": "https://example.com/hooks/hoodgrow",
  "webhookSecret": "whsec_a1b2c3d4e5f60718293a4b5c6d7e8f90",
  "note": "Deliveries are signed x-hoodgrow-signature: sha256=<hex>. Each fired event is billed $0.15 against your credit balance."
}

Registered (or updated).