Get started

API connections

Kai connects to four external tools to do its work. All connections are configured in the Settings panel inside the app. This guide covers what each connection does, where to find the credentials, and how to verify everything is working.

Where to find the integrations panel

Go to Settings in the left sidebar of the Kai dashboard. The Integrations section is near the top of the page. Each integration has an API key field and a status badge showing whether the connection is active.

Integrations
Lemlist
Connected
API key
Firecrawl
Connected
API key
HubSpot
Not connected
API key
The Integrations section in Kai Settings. Each connection shows a status badge. Green means the key is present and valid. Red means the connection is missing or broken.

Lemlist

Lemlist is where your contacts live and where sequences execute. Kai reads your Lemlist campaign structure, pushes approved contacts into sequences, and listens for replies. This is the most critical connection. Without it, Kai cannot push anything live.

Finding your Lemlist API key

1
Open Lemlist

Log in at app.lemlist.com.

2
Go to Settings, then Integrations

In the left sidebar, click your account name at the bottom, then Settings. Find the Integrations or API section.

3
Copy the API key

Your API key starts with lem_. Copy it and paste it into the Lemlist field in Kai Settings, then click Save.

Check your Lemlist plan includes B2B database access. ABM persona discovery and 24/7 sourcing both use Lemlist's B2B contact database. This is a paid add-on on some Lemlist plans. If candidate discovery returns no results, check that the B2B database is included in your plan.

Firecrawl

Firecrawl is Kai's research engine. Before writing any outreach, Kai uses Firecrawl to crawl the prospect's company website and pull recent content, product pages, and news. This raw data becomes the personalised hooks and angles in each sequence. Without Firecrawl, Kai has no live research and falls back to generic outreach.

Finding your Firecrawl API key

1
Go to firecrawl.dev

Sign up or log in at firecrawl.dev.

2
Open the dashboard and find API Keys

Your key starts with fc-. Copy it and paste it into the Firecrawl field in Kai Settings.

HubSpot (optional)

HubSpot handles the handoff from Kai to the rep. When a contact reaches the call step in a sequence, Kai creates a task in HubSpot with the call brief. When a contact is classified as Interested, Kai assigns them to the rep in HubSpot. This connection is optional to get started, but you need it for the full handoff workflow to function.

Finding your HubSpot credentials

1
Open HubSpot Settings

In HubSpot, go to Settings (the gear icon), then Integrations, then Private Apps.

2
Create a private app

Click Create a private app. Give it a name like "Kai BDR". Under Scopes, enable read and write access for Contacts, Deals, and Tasks.

3
Copy the access token

The token starts with pat-na-. Paste it into the HubSpot API key field in Kai Settings. Also add your Pipeline ID from the Deals section of HubSpot, then click Save.

Claude (optional)

Kai uses Claude for all intelligence: sequence generation, research distillation, reply classification, and call briefs. The platform comes with a shared Claude API key, so you do not need to add your own to get started. You can add a personal Claude API key in Settings if you want usage billed to your own Anthropic account or want to apply your own rate limits.

Verifying connections

Each integration in Settings shows a status badge: Connected (green) when a valid key is present, Not connected (red) when the key is missing or rejected by the service. The fastest way to confirm everything is working end to end is to create a campaign, pull the Lemlist steps (confirms Lemlist is connected), then run one contact through the pipeline. If research runs and a sequence appears in Approvals, Firecrawl and Claude are both working.

Keep API keys private. Do not share them in email, chat, or screenshots. If a key is accidentally exposed, rotate it immediately in the relevant dashboard and paste the new one into Kai Settings.
Previous Overview