Follow Up Boss (CLI)

---

name: follow-up-boss

description: CLI 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

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

2. **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