follow-up-boss

// CLI for interacting with the Follow Up Boss API. Manage people, notes, tasks, events, deals, webhooks, and more.

$ git log --oneline --stat

stars:1,933

forks:367

updated:March 4, 2026

SKILL.mdreadonly

SKILL.md Frontmatter

namefollow-up-boss

descriptionCLI for interacting with the Follow Up Boss API. Manage people, notes, tasks, events, deals, webhooks, and more.

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