Common failures
Redbark splits large syncs into requests of up to 500 records. Your endpoint should validate and acknowledge the request quickly, then move expensive processing to a queue or background job.
Documentation Index
Fetch the complete documentation index at: /docs/llms.txt
Use this file to discover all available pages before exploring further.
Use delivery history to diagnose endpoint errors, timeouts, public reachability, and an auto-disabled webhook.
| Result | What to check |
|---|---|
| 401 or 403 | Confirm your endpoint’s authentication and Redbark signature verification. |
| 404 | Check the configured path and deployment route. |
| 429 | Reduce endpoint rate limiting or accept batch requests. Redbark retries rate-limit responses. |
| 5xx | Check the endpoint’s application logs. Redbark retries server errors. |
| Timeout | Return a 2xx response within 30 seconds. Acknowledge first and process larger batches asynchronously. |
| DNS or connection error | Use a publicly reachable HTTPS hostname. Private IPs, private DNS, IP literals, and internal-only Tailscale hostnames cannot receive deliveries. |
