API Reference
Dashboard
  1. API Reference
  2. ProxyMarket API
  3. Webhooks

Health check of your server (keeps your plans listed)

Build this first. ProxyMarket sends HEAD {webhook_url}/health when you create a key (no answer: the key is refused with 422) and then every 10 minutes. Any status below 500 within 5 seconds counts as up; a timeout, a refused connection or a 5xx counts as down.

After 2 failures in a row, every plan of that key is hidden from the marketplace and cannot be bought. One good answer brings them all back by itself. So a deploy, a restart or a firewall that blocks HEAD can empty your shop within about 20 minutes. Keep this route cheap: no login, no database, no outside call, and answer GET too. Not to be confused with Report the health of your proxies, which you call.

  • Read only
  • No authentication
  • webhookHealth
HEAD/health

Authentication

No signature and no login. ProxyMarket sends no body and reads only the status code.

Responses

Up. Any status below 500 works; an empty 200 is best.

Verified against ProxyMarket vendor guide v1.11 on Nov 20, 2026