Skip to main content
These are the commands that are more than one API call. Like everything else in the CLI, each one acts on your account through Hookie, exactly as the console and the MCP tools do. Nothing is received on, or forwarded to, the machine the CLI runs on.

Send a test event

send posts to the endpoint’s public URL, the same one a provider posts to, so the event takes the same path through ingest, the endpoint’s criteria and mappings, and delivery as any other. The answer says where it was routed. --endpoint takes an endpoint’s readable base slug, its ID, its name, or a full workspace/project/slug path.

Add a form

forms init creates the endpoint with the template’s fields, a honeypot and the origins you give it, adds the destination you ask for, and writes the form into your project. forms test posts a sample submission and reports the record. Templates, flags and the checks Hookie runs are in Forms.

Find what arrived, and what failed

Search reads what your account stored: records, the raw submissions behind them, and deliveries, with a time window and paging. --since takes a duration (30m, 2h, 7d) or a timestamp.

Replay a bad window

The bulk form uses the server’s bulk replay (POST /admin/api/projects/{project_id}/deliveries/replay). It asks the server how many deliveries match first and asks you to confirm that number, since every replay sends a real request to a real destination; with no one to ask (a script, an agent) it refuses unless given --yes. It then replays in passes of up to 500 until nothing matches or --limit (default 100) is reached.
Only what did not arrive, once per event. --failed covers dead deliveries and failed ones with no retry scheduled; deliveries still being retried automatically are left to their retries. The server replays only the latest delivery of each event to each destination, so an event whose original and replay both failed is sent once, and running the command twice does not send anything twice. Events past your plan’s retention are not included.
Each replay is a new delivery and counts against the monthly delivery allowance. When the allowance runs out the run stops there, says how many are left, and exits non-zero.

Open the console at a project

Prints the URL and opens it. The print is what makes it work over SSH and on a headless box.