Follow Up Boss (CLI)
CLI for interacting with the Follow Up Boss API.
Setup
-
Get API Key: Follow Up Boss → Admin → API → Create API Key
-
Set Environment Variable:
export FUB_API_KEY="fka_xxxxxxxxxxxx"
CLI Usage
node fub.js <command> [options]
Commands
| Command | Description |
|---|---|
me | Current user info |
people [query] | List/search people |
person <id> | Get person details |
people create <json> | Create person via /events (triggers automations) |
people update <id> <json> | Update a person |
notes <personId> | Get notes for a person |
notes create <json> | Create a note |
tasks [query] | List tasks |
tasks create <json> | Create a task |
tasks complete <id> | Complete a task |
events [query] | List events |
events create <json> | Create event (for lead intake) |
pipelines | Get pipelines |
deals [query] | List deals |
deals create <json> | Create a deal |
textmessages <personId> | Get text messages for a person |
textmessages create <json> | Log a text (NOT sent - recorded only!) |
emails <personId> | Get emails for a person |
emails create <json> | Log an email (NOT sent - recorded only!) |
calls <personId> | Get calls for a person |
calls create <json> | Log a call |
webhooks | List webhooks |
webhooks create <json> | Create webhook |
webhooks delete <id> | Delete webhook |
sources | Get lead sources |
users | Get users/agents |
search <query> | Global search |
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