
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 thefiq_ prefix in the Authorization header:
Base URL
What you can build
Text, media, location, contact cards, interactive buttons and lists, reactions
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 shorterror 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

