Skip to main content
FlowIQ
The FlowIQ API connects your own systems to your FlowIQ account. Send messages and approved templates on WhatsApp, Instagram and Messenger, answer and place WhatsApp calls, create and look up contacts, read conversations on every channel, keep your own copy of tickets, subscriptions and reports, and receive events on your server the moment they happen. One API key covers all of it.

Quick example

Send a WhatsApp message to a contact:
Free-form messages like this one can only be sent within 24 hours of the contact’s last message to you (WhatsApp’s customer service window). To start a conversation, use Send Template.

Authentication

Every request needs an API key with the fiq_ prefix in the Authorization header:
Create a key in the FlowIQ Dashboard under Settings → Profile → API Keys. If you don’t see the API Keys section, ask FlowIQ support to enable API access for your organization. The key identifies your organization, so you never pass an organization ID.
Treat your key like a password. Never put it in client-side code or a public repository.

Base URL

What you can build

WhatsApp

Text, media, location, contact cards, interactive buttons and lists, reactions

Instagram

Text, images, video, audio, conversations and webhook events

Messenger

Text, images, video, audio, files, conversations and webhook events

Calling

Answer, decline, start and end WhatsApp calls from your own server, with call history and transcripts

Templates & Broadcasts

Send approved templates and measure delivery, clicks and revenue

Contacts & Conversations

Create and find contacts, read and search message history on every channel

Subscriptions

Read subscriptions and upcoming deliveries, and get an event for every change

Webhooks

Messages, receipts, calls, tickets and subscription changes on your server as they happen, retried and logged

Reporting API

Tickets, contact reasons, campaign revenue, orders and more, for dashboards and data warehouses

AI Assistants (MCP)

Connect Claude or ChatGPT to your FlowIQ account

Errors

Errors return a JSON body with a short error and a readable message. The endpoints under /v1 (Calling, Subscriptions, the Reporting API, the webhook delivery log) also return a stable code and a request_id: see Conventions.

Rate limits

Message sends are subject to WhatsApp’s own limits: how fast a number can send, and how many new conversations it can start per day for its messaging tier. The endpoints under /v1 allow 240 reads and 60 actions a minute per key, and every response says where you stand (Conventions).

Next steps

Quickstart

Send a message and read the conversation back in five minutes

Webhook events

See every event FlowIQ can send to your server

Ticket events

Hear about every ticket the AI hands to your team, and every change after

Syncing your tickets

Keep a copy of every ticket in your own database or warehouse