API

The Flow AI REST API lets you read and write data from your own apps. Use it to sync with your CRM, build custom dashboards, or automate workflows.

Overview

The API uses standard HTTP and JSON. You send requests to the base URL with your API key, and responses come back as JSON. Typical uses: pull your leads and lists, update a lead’s status, start or pause outreach on a list, schedule LinkedIn actions, or pull dashboard metrics.

Authentication

The API uses API keys. Create one in Settings → API Keys and give it a name. Only company admins can create or revoke keys; if you’re not an admin, ask one on your team. The full key is shown only once, when you create it, so copy it then. Keys start with flow_live_. A key acts as the person who made it, so keep it secret and never put it in client-side code or a public repo. You can revoke a key at any time from the same tab.

Send the key as a bearer token on every request:

Authorization: Bearer flow_live_YOUR_API_KEY

To check it works, call GET /auth/me. It returns the account the key acts as and changes nothing:

curl https://api.chooseflow.ai/auth/me \
  -H "Authorization: Bearer flow_live_YOUR_API_KEY"
Flow’s Settings → API Keys tab: the Use the Flow API steps, a Read API docs button, and the API keys table with the Create key button highlighted
Create and manage API keys in Settings → API Keys. The same tab links to the full API reference.

Connecting an AI assistant? You don’t need a key for that. Most assistants connect by signing in with Flow. See Connect AI assistant and the MCP reference.

Base URL and reference

All requests go to https://api.chooseflow.ai. Every endpoint, with its parameters and responses, is in the API reference. You can also open it from the Read API docs button in Settings → API Keys.

Webhooks push events to you when something happens. The API is for on-demand read and write. Use both together if you want real-time events plus custom queries and updates.

⌘I