# Honk

> Honk is a calm inbox for events from anything that can call a URL: apps, scripts, cron jobs, CI, servers, online shops, forms and home automations. One HTTPS request (POST /v1/messages) sends an event; Honk groups repeats into episodes and pushes only the first sign of trouble to iPhone, Apple Watch and the browser, then calm updates.

- Sending: `POST https://honk-honk.app/v1/messages` with `Authorization: Bearer <ingestion key>` and a JSON body; `message` is the only required field. `202` means durably stored, not pushed.
- Use `group_key` so repeats of one problem fold into one group; `event_type: "problem"` and `"recovery"` open and close an incident for that key.
- Severity takes `info | success | warning | error | critical` or the horn aliases `light | beep | loud | long | blast`.
- Send an `Idempotency-Key` header that stays the same for the same event; retries within 24 h return the original id.
- Keep the ingestion key (`honk_…`) on servers and in CI secrets, never in browser, mobile or desktop apps.
- Connections: Stripe, Shopify, GitHub, Sentry, Grafana or Prometheus Alertmanager, and Uptime Kuma can post their own webhooks to a project without code. A project admin creates one in the web app (project ▸ Connections) and pastes its URL (`https://honk-honk.app/v1/hooks/<provider>/<token>`) into the service; Honk verifies the signature and maps each event to a level, with problems and recoveries. The guides below show each one.
- Honk is invite-only for now: people request access at https://honk-honk.app/request-access.

## Docs

- [Sending events](https://honk-honk.app/docs.md): the request, every field, responses, idempotency and the Honk scale
- [OpenAPI 3.1](https://honk-honk.app/docs/openapi.yaml): the ingestion API as an OpenAPI document
- [How Honk works](https://honk-honk.app/how-it-works): groups, episodes, what gets pushed, quiet hours, digests, workspaces and projects

## Libraries (MIT, README on GitHub)

- [Laravel and PHP](https://raw.githubusercontent.com/honk-hq/php/main/README.md): Facade, notification channel, exception reporting, scheduler hooks and Honk::fake() for Laravel 13. A plain client for any PHP 8.3 app. Page: https://honk-honk.app/integrations/laravel
- [Node.js](https://raw.githubusercontent.com/honk-hq/node/main/README.md): TypeScript client with ESM and CommonJS builds and no dependencies. Runs on Node 18+, Bun and Deno. Page: https://honk-honk.app/integrations/node
- [Go](https://raw.githubusercontent.com/honk-hq/go/main/README.md): Context-aware client, standard library only, safe for concurrent use. Ships with the honk CLI. Page: https://honk-honk.app/integrations/go
- [Swift](https://raw.githubusercontent.com/honk-hq/honk-swift/main/README.md): Swift 6.2 client with strict concurrency and async/await, for server-side Swift, macOS tools and Linux. Page: https://honk-honk.app/integrations/swift
- [Kotlin and Java](https://raw.githubusercontent.com/honk-hq/kotlin/main/README.md): Suspend API for Kotlin, blocking and CompletableFuture for Java, on java.net.http. JDK 17+. Page: https://honk-honk.app/integrations/kotlin
- [Rust](https://raw.githubusercontent.com/honk-hq/rust/main/README.md): Async client on Tokio and reqwest with rustls, plus a blocking client. Rust 1.85+, no unsafe code. Page: https://honk-honk.app/integrations/rust
- [CLI and cURL](https://raw.githubusercontent.com/honk-hq/go/main/README.md): The honk command for shell scripts, cron and CI, or a single cURL request. Page: https://honk-honk.app/integrations/cli
- [n8n](https://raw.githubusercontent.com/honk-hq/n8n/main/README.md): A community node with one action, Honk → Send message, and an idempotency key on every item. Page: https://honk-honk.app/integrations/n8n

## Guides

- [WooCommerce order notifications on your iPhone](https://honk-honk.app/guides/woocommerce-order-notifications.md): A WordPress plugin sends Honk your orders, failed payments, stock alerts and form entries. You choose what each notification says.
- [Stripe payment notifications on your iPhone](https://honk-honk.app/guides/stripe-payment-notifications.md): Paste one URL into Stripe: failed payments, disputes and failed payouts push to your iPhone, and sales can too.
- [Shopify order notifications on your iPhone](https://honk-honk.app/guides/shopify-order-notifications.md): Shopify’s webhooks, straight to Honk: a Beep-beep for each new order, a Loud honk for cancellations and refunds.
- [Contact form notifications on your iPhone](https://honk-honk.app/guides/form-submissions-to-your-phone.md): Every contact or quote form submission as a push with all its fields, from WordPress, hosted form tools or your own code.
- [Website down alerts on your iPhone](https://honk-honk.app/guides/website-down-alerts.md): One push when your site goes down and one when it’s back up, from a cron check or Uptime Kuma.
- [Uptime Kuma notifications on your iPhone](https://honk-honk.app/guides/uptime-kuma-notifications.md): One webhook notification in Uptime Kuma: a push when a monitor goes down, a recovery when it’s back, one group per monitor.
- [Home Assistant alerts on your iPhone](https://honk-honk.app/guides/home-assistant-iphone-alerts.md): A rest_command for configuration.yaml, a leak alert that folds its repeats, and a doorbell with a snapshot.
- [n8n workflow notifications on your iPhone](https://honk-honk.app/guides/n8n-workflow-notifications.md): The Honk node or the HTTP Request node, plus an error workflow that reports every failed execution.
- [Cron job failure notifications on your iPhone](https://honk-honk.app/guides/cron-job-push-notifications.md): One crontab line that honks when a job fails, and a wrapper that also tells you when it works again.
- [Cron job monitoring: know when a job stops running](https://honk-honk.app/guides/cron-job-monitoring.md): A check-in URL for each job. When the calls stop, Honk opens a problem and pushes, then closes it when the job runs again.
- [GitHub Actions failure alerts on your iPhone](https://honk-honk.app/guides/github-actions-failure-alerts.md): Connect GitHub’s webhook, or add one workflow step: failed runs push, folded per branch, with a recovery when it’s green.
- [Sentry alerts as iPhone push notifications](https://honk-honk.app/guides/sentry-alerts-iphone.md): A Sentry internal integration sends issues and alerts to Honk: new issues push, and resolving them sends a recovery.
- [Grafana and Alertmanager alerts on your iPhone](https://honk-honk.app/guides/grafana-alertmanager-alerts.md): A webhook contact point or receiver sends alerts to Honk: firing opens a problem, resolved closes it, one group per rule.
- [Laravel exception notifications on your phone](https://honk-honk.app/guides/laravel-exception-notifications.md): One line in bootstrap/app.php, throttled per exception, plus scheduler hooks and a fake for tests.
- [Customer requests from your app to your phone](https://honk-honk.app/guides/customer-requests-to-your-phone.md): Each new quote or contact request as one push with its details, ready to answer from your phone.
- [Deploy notifications from any CI](https://honk-honk.app/guides/deploy-notifications.md): A failed deploy pushes right away and the next good one closes it. One pattern for GitHub Actions, GitLab CI and shell scripts.
- [Push to your iPhone when Claude Code needs input](https://honk-honk.app/guides/claude-code-notifications.md): Two Claude Code hooks that push when it asks for permission or finishes, with repeats folded into one notification per project.
- [Stop alert fatigue with fewer, better notifications](https://honk-honk.app/guides/stop-alert-fatigue.md): Why repeats teach you to ignore alerts, and six habits that fix it, plus a checklist for group keys.
- [Pushover alternative for iPhone and Apple Watch](https://honk-honk.app/guides/pushover-alternative.md): Honk next to Pushover, ntfy and Pushbullet. What each one does well, where Honk differs, and Honk’s limits.

## Optional

- [Pricing and limits](https://honk-honk.app/pricing)
- [Privacy Policy](https://honk-honk.app/privacy)
- [Support](https://honk-honk.app/support)
- The site in Romanian, Spanish, French and German: https://honk-honk.app/ro, https://honk-honk.app/es, https://honk-honk.app/fr, https://honk-honk.app/de (guides have .md twins in each language)