post

Probes a URL before a webhook is created or before an edited URL is saved. No webhook record is required — this is a pre-save validation step.

The server sends a HEAD request (falling back to GET if HEAD is rejected) from TelegraMD's outbound IPs. Any HTTP response code is considered reachable; only network-level failures (timeout, DNS error, connection refused) return reachable: false.

Request body

Response 200

{
  "reachable": true,
  "statusCode": 200,
  "latencyMs": 124,
  "checkedAt": "2026-05-30T14:00:00.000Z",
  "url": "https://api.example.com/webhooks",
  "persisted": false
}

persisted: false indicates this was a pre-save check; the result is not stored on any webhook record.

Required role

affiliate_super_admin or affiliate_admin