CLI

CLI

The same bookedin package that ships the Python SDK installs a bookedin command — for shell scripts, or for an AI agent (Claude Code, Claude Desktop, Hermes) to call the API directly without writing Python.

Installation

$pip install bookedin

Quick start

$export BOOKEDIN_API_KEY="your_api_key"
$
$bookedin doctor # verify auth and connectivity
$bookedin agents list

Available commands

$# Agents
$bookedin agents list
$bookedin agents create --name "..." --prompt "..." --objective "..."
$bookedin agents get <agent_id>
$bookedin agents update <agent_id> --prompt "..."
$bookedin agents delete <agent_id>
$bookedin agents clone <agent_id>
$bookedin agents test <agent_id> --message "..."
$bookedin agents assign-tools <agent_id> <channel_type> <tool_ids>
$bookedin agents assign-channel <agent_id> <channel_type> <account_id>
$
$# Leads
$bookedin leads list --search "..." --limit 50
$bookedin leads create --first-name "John" --phone "+15551234567"
$bookedin leads get <lead_id>
$bookedin leads update <lead_id> --email "..."
$bookedin leads delete <lead_id>
$
$# Strategies
$bookedin strategies list
$bookedin strategies get <strategy_id>
$bookedin strategies execute <strategy_id> <lead_id>
$
$# Pipelines & phone numbers
$bookedin pipelines list
$bookedin phone-numbers search --country US
$bookedin phone-numbers purchase <phone_number>
$bookedin phone-numbers assign <phone_number_id> <agent_id>
$
$# Channels & tools
$bookedin channels connect WHATSAPP
$bookedin channels list
$bookedin tools list-available
$
$# Execute
$bookedin execute --lead-id <lead_id> --agent-id <agent_id> --channel sms
$bookedin scheduled
$bookedin cancel-scheduled <execution_id>
$bookedin campaign <campaign_id>

Run bookedin --help or bookedin <resource> --help for the full flag list on any command.

Built for agents, not just humans

Every command prints JSON to stdout on success, JSON to stderr and exits 1 on failure — no separate agent mode needed, pipe it straight into jq or into whatever an agent is running.

$$ bookedin agents list
$Error: {"error": "Invalid API key", "status_code": 401}
$$ echo $?
$1