Follow Up Boss (CLI)

CLI for interacting with the Follow Up Boss API.

Setup

1. Get API Key: Follow Up Boss → Admin → API → Create API Key

1. Set Environment Variable:

export FUB_API_KEY="fka_xxxxxxxxxxxx"

CLI Usage

node fub.js <command> [options]

Commands

Examples

# List people
node fub.js people "limit=10"

# Get person
node fub.js person 123

# Create a lead (triggers automations!)
node fub.js events create '{"source":"Website","system":{"name":"John Doe","email":"john@test.com","phone":"5551234567"}}'

# Add a note
node fub.js notes create '{"personId":123,"body":"Called - left voicemail"}'

# Create task
node fub.js tasks create '{"personId":123,"body":"Follow up","dueDate":"2026-02-20"}'

# Complete task
node fub.js tasks complete 456

# Log a text (NOT sent - recorded!)
node fub.js textmessages create '{"personId":123,"body":"Hey!","direction":"outbound"}'

# Log a call
node fub.js calls create '{"personId":123,"direction":"outbound","outcome":"voicemail"}'

# Search
node fub.js search "john"

Important Notes

• Text/Email Logging: The API can log texts and emails but cannot actually send them. Use FUB's built-in texting or integrations like SendHub for sending.
• Rate Limits: GET /events: 20 req/10 sec, All else: 250 req/10 sec