Skip to main content
These Instagram endpoints and webhook events are prepared for rollout and are not yet deployed.
Instagram uses the same organization API key and webhook registration endpoints as WhatsApp. Use the FlowIQ API for all Instagram messages and events.

​
Authentication and recipients

Send Authorization: Bearer fiq_YOUR_API_KEY to https://api.flowiq.live. The key identifies your organization; no organization ID is needed. Messages go to an existing Instagram contact. Use either contact_id (the FlowIQ contact UUID) or instagram_id (the Instagram-scoped ID as a string). A username or phone number is not an Instagram recipient ID. Use Instagram Conversations to list contacts and obtain their IDs.

​
Messages and history

Text supports 1–1000 characters. Media requires a public HTTPS URL; send captions as separate text messages. Instagram permissions and messaging windows still apply. WhatsApp templates, calls, documents and broadcasts are not supported by these Instagram endpoints. History comes from messages already stored in the FlowIQ inbox. Reading it does not mark messages as read or import earlier Instagram history. Only Instagram messages are returned, including when a contact also has a WhatsApp conversation.

​
Webhooks

Use the existing webhook API with platform: "instagram":
Receive incoming messages, outgoing content, send confirmations and recorded receipt changes. Instagram Events documents each event and its identifiers. Delivery uses the same authentication options, static headers and HMAC signature verification as WhatsApp. List registrations using GET /get-webhooks?platform=instagram, and remove one using DELETE /set-webhooks with its id. See Create Webhook, List Webhooks and Delete Webhook.