# Hooksbase Docs

Hooksbase helps you receive inbound events, deliver them to your app, and operate the full lifecycle from one place. These docs cover the dashboard product, the project-authenticated Public API, and the public ingest endpoints that power real event delivery.

[Quickstart](/docs/quickstart.md)

[Explore the dashboard](/docs/dashboard.md)

## Overview

Most teams start in the [Hooksbase dashboard](https://app.hooksbase.com), create a project, provision a webhook, and then move into the API or SDK once they want repeatable automation. Hooksbase keeps those surfaces aligned: the dashboard manages project state and guided setup, the Public API manages live webhook infrastructure, and the public ingest endpoints accept the events you send.

[Open the dashboard](https://app.hooksbase.com)

## Choose your path

- **Dashboard users** `no code`: Start with the [dashboard path](/docs/quickstart.md#dashboard-path). Create a project, follow onboarding, validate one webhook, inspect the first delivery, invite teammates, and manage billing without touching an API.
- **Developers** `API / SDK`: Start with the [API and SDK path](/docs/quickstart.md#api-and-sdk-path). Use public routes, the TypeScript SDK, webhook ingest, signature verification, errors, and pagination to build integrations.
- **Agents and LLMs** `CLI`: Start with the [CLI and agent path](/docs/quickstart.md#cli-and-agent-path). Use `hooksbase`, `--json`, cursor-safe reads, idempotency keys, and a re-read-after-mutation loop.

## Choose your surface

- **Dashboard** `session auth`: Use the [Hooksbase dashboard](https://app.hooksbase.com) for project creation, onboarding, team management, billing, delivery inspection, and other product workflows. The dashboard is the product surface — there are no public API routes for it.
- **Public API** `project API key`: Use the project-authenticated API for webhook configuration, delivery history, replay, usage, and operational automation. These requests use `Authorization: Bearer swk_...`.
- **Public ingest** `webhook secret`: Use public ingest to publish events into a webhook. These requests go to `/v1/ingest/{publicId}` and authenticate with `Authorization: Bearer whsec_...`.
- **Public reference** `customer-facing routes`: Use the [Public API reference](/docs/api-reference.md) to confirm route families, auth requirements, and SDK/CLI coverage. Browser-only dashboard workflows stay documented as product guides, not endpoints.

## Start here

- [Quickstart](/docs/quickstart.md): Choose a dashboard, API/SDK, or CLI path for your first working webhook.
- [AI agents](/docs/agents.md): Use the CLI as the stable control plane for coding agents, terminal automations, and scripted operator loops.
- [Dashboard overview](/docs/dashboard.md): Use the UI for project setup, onboarding, delivery inspection, teams, and billing.
- [Public API reference](/docs/api-reference.md): Confirm customer-facing routes, credentials, and first-party client coverage.
- [Projects and settings](/docs/projects.md): Understand project boundaries, API keys, logo management, and destructive settings changes.
- [Team and invites](/docs/team.md): Invite teammates, manage roles, and understand invitation preview and accept flows.
- [Onboarding](/docs/onboarding.md): Use workflow blueprints and guided validation to get to a working first flow faster.

## Core workflows

- [Authentication](/docs/authentication.md): Choose the right credential for dashboard access, project APIs, ingest, and outbound verification.
- [Public API reference](/docs/api-reference.md): Browse public route families, auth requirements, and SDK/CLI coverage without dashboard-only routes.
- [Webhooks](/docs/webhooks.md): Create inbound endpoints, configure lifecycle controls, and understand delivery settings and tiers.
- [Ingest](/docs/ingest.md): Publish events over the public ingest endpoint with idempotency, scheduling, and content-type awareness.
- [Deliveries and replay](/docs/deliveries.md): Inspect attempts, replay failed work, and understand how delivery history, DLQ, and files relate.
- [Billing](/docs/billing.md): Understand plan upgrades, checkout and manage flows, and overage framing.
- [Limits and quotas](/docs/limits.md): Check tier quotas, feature gates, file limits, replay windows, and retention behavior.