FoxReach CLI

Command-line interface for the FoxReach cold email outreach API.

Installation

pip install foxreach-cli

Setup

# Save your API key
foxreach config set-key
# Enter: otr_your_api_key

# Verify
foxreach config show

You can also use environment variables:

export FOXREACH_API_KEY=otr_your_api_key
export FOXREACH_BASE_URL=https://api.foxreach.io/api/v1  # optional

Usage

Leads

foxreach leads list
foxreach leads list --search "jane" --status active
foxreach leads list --email jane@example.com   # exact, case-insensitive match
foxreach leads get cld_abc123
foxreach leads create --email jane@example.com --first-name Jane --company "Acme"
foxreach leads update cld_abc123 --company "New Corp"
foxreach leads delete cld_abc123

Campaigns

foxreach campaigns list
foxreach campaigns list --status active
foxreach campaigns get cmp_xyz789
foxreach campaigns create --name "Q1 Outreach" --daily-limit 100
foxreach campaigns update cmp_xyz789 --daily-limit 200
foxreach campaigns start cmp_xyz789
foxreach campaigns pause cmp_xyz789
foxreach campaigns add-leads cmp_xyz789 --lead-ids cld_1,cld_2,cld_3
foxreach campaigns add-accounts cmp_xyz789 --account-ids acc_1
foxreach campaigns delete cmp_xyz789

Sequences

foxreach sequences list --campaign cmp_xyz789
foxreach sequences create --campaign cmp_xyz789 --subject "Hi {{firstName}}" --body "Hello!"
foxreach sequences update --campaign cmp_xyz789 --sequence seq_1 --delay-days 3
foxreach sequences delete --campaign cmp_xyz789 --sequence seq_1

Templates

foxreach templates list
foxreach templates get tpl_abc123
foxreach templates create --name "Follow-up" --body "Hi {{firstName}}, just checking in."
foxreach templates update tpl_abc123 --name "New Follow-up"
foxreach templates delete tpl_abc123

Email Accounts

foxreach accounts list
foxreach accounts get acc_abc123
foxreach accounts delete acc_abc123

Inbox

foxreach inbox list
foxreach inbox list --unread --category interested
foxreach inbox get rpl_abc123              # does not mark the thread read
foxreach inbox get rpl_abc123 --mark-read  # marks it read
foxreach inbox update rpl_abc123 --read --category qualified

Analytics

foxreach analytics overview
foxreach analytics campaign cmp_xyz789

JSON Output

Add --json to any command to get raw JSON output for scripting:

foxreach leads list --json | jq '.data[].email'
foxreach campaigns get cmp_xyz789 --json

Configuration

Config is stored at ~/.foxreach/config.json. Environment variables take precedence: