Chatspark
Pricing
⌘K
⌘K

Follow Up Boss

Connect your customer-facing AI Agent and your internal ChatSpark CoPilot to Follow Up Boss CRM. Capture leads automatically from chat and give your team live pipeline access from the browser sidebar.

7 min read

Updated October 2026

Overview

The Follow Up Boss integration gives you two layers of value. Your customer-facing AI Agent captures leads through chat and creates them in Follow Up Boss with full conversation context. Your internal ChatSpark CoPilot agent lets your team query the pipeline, search contacts, log notes, and manage tasks without leaving the browser.

Customer-Facing Actions

These actions run on your website, Instagram, Messenger, and other channels where visitors interact with your AI Agent.

Customer-facing lead creation uses the Create Lead action when it is available in your current library. Configure and test it before promising automatic lead delivery. The internal actions listed below are separate from that lead-capture flow.

Automatic Lead Capture
The Create Lead action works with ChatSpark's built-in lead capture flow. On websites visitors see a clean contact form. On social channels the AI collects details conversationally. Either way, Follow Up Boss gets the full picture.

CoPilot Actions (Internal Use)

These actions are designed for your team using ChatSpark CoPilot in the browser sidebar. They connect directly to your Follow Up Boss data so agents can query, update, and manage contacts without switching tabs.

Available actions depend on your agent type and plan. Customer-facing actions serve customers. Internal team actions are for authenticated team use. AI CoPilot is Enterprise-only. Plus enables up to 5 actions per agent, Pro enables 40, and Enterprise has no enabled-action limit.

ActionDescriptionAudience
Add CollaboratorAdd a team member as a collaborator on a Follow Up Boss contactInternal team
Add NoteAdd a note to a contact record in Follow Up BossInternal team
Add RelationshipAdd a relationship (Spouse, Partner, family member, etc.) to a Follow Up Boss contactInternal team
Complete TaskMark an existing task as complete in Follow Up BossInternal team
Create AppointmentCreate an appointment in Follow Up BossInternal team
Create Custom FieldCreate a new custom field definition in Follow Up BossInternal team
Create DealCreate a new deal in Follow Up Boss and associate it with a contactInternal team
Create TaskCreate a follow-up task for a contact in Follow Up BossInternal team
Delete AppointmentCancel and delete an appointment from Follow Up BossInternal team
Delete TaskDelete a task from Follow Up BossInternal team
Get AppointmentsView upcoming appointments in Follow Up BossInternal team
Get Contact ActivityFetch a contact's property activity history from Follow Up Boss (inquiries, viewed/saved properties, and saved searches)Internal team
Get Contact DetailsGet full contact details including notes and tasks from Follow Up BossInternal team
Get Deal StagesList available deal pipeline stages in Follow Up BossInternal team
Get DealsView deals associated with a Follow Up Boss contactInternal team
Get PipelineList contacts by pipeline stage or assigned agent in Follow Up BossInternal team
Get TasksView upcoming or overdue tasks in Follow Up BossInternal team
Log CallLog a phone call to a contact's activity timeline in Follow Up BossInternal team
Search ContactsSearch contacts in Follow Up Boss by name, email, phone, or tagInternal team
Send EmailLog an email to a contact's activity timeline in Follow Up BossInternal team
Send TextLog a text message to a contact's activity timeline in Follow Up BossInternal team
Update AppointmentReschedule or update an existing appointment in Follow Up BossInternal team
Update ContactUpdate a contact's details in Follow Up Boss including phone, email, name, address, tags, or background notesInternal team
Update Contact StageMove a contact to a different pipeline stage in Follow Up BossInternal team
Update Custom FieldUpdate any custom field on a Follow Up Boss contact by field label and valueInternal team
Same API Key
Both customer-facing and ChatSpark CoPilot actions use the same Follow Up Boss API key. No additional credentials are required.

Prerequisites

Before setting up the Follow Up Boss integration, you'll need:

  • A Follow Up Boss account
  • Admin access to generate API credentials

Setup Instructions

Step 1: Get Your API Key

  1. Log in to your Follow Up Boss account
  2. Go to Admin → API
  3. Click Create API Key if you don't have one
  4. Copy your API Key

Step 2: Enable in ChatSpark

  1. In ChatSpark, go to AI Actions
  2. Find Follow Up Boss in the Library and click Enable
  3. Select the AI Agent(s) that should have access
  4. Enter your API Key
  5. Click Save
Two Agents, One Key
Enable the customer-facing actions on your website AI Agent and the ChatSpark CoPilot actions on your internal AI Agent. Both share the same API key.

Configuration Fields

FieldDescriptionExample
API KeyYour Follow Up Boss API keyfub_xxxxx...

Lead Capture Details

When the AI creates a lead in Follow Up Boss, it includes:

  • Contact info: Name, email, phone number
  • Source: Marked as coming from ChatSpark with channel attribution
  • Notes: Full conversation summary and specific interests
  • Property data: MLS numbers and listing details when available

Leads appear in Follow Up Boss immediately and are assigned via your existing Lead Flow rules and action plans.

Events API
ChatSpark uses Follow Up Boss's Events API for lead creation. This ensures leads are properly tracked with source attribution and trigger your existing automations.

Testing Your Integration

Customer-Facing

  1. Open your AI Agent widget
  2. Have a conversation and provide contact details
  3. Check Follow Up Boss for the new lead

CoPilot

  1. Open ChatSpark CoPilot in your browser sidebar
  2. Ask “Show me all my Hot leads”
  3. Verify the results match your Follow Up Boss pipeline

Troubleshooting

Leads not appearing

  • Check that your API key is correct and has write permissions
  • The lead email may already exist in Follow Up Boss (events update existing records)

CoPilot returns empty results

  • Verify the API key has read access to contacts, notes, and tasks
  • Check that the stage names in your prompts match your Follow Up Boss stages exactly

Invalid API key

Generate a new API key in Follow Up Boss if your current one isn't working. Ensure you're copying the full key.

Need Help?
If you're having trouble with the Follow Up Boss integration, contact our support team and we'll help you troubleshoot.
Also: Built-in Lead Capture
ChatSpark's built-in Lead Capture works great alongside Follow Up Boss. Collect contact info conversationally, then let this integration push it directly into your CRM in real time.

Previous

FireHydrant

Next

Freshchat