> ## Documentation Index
> Fetch the complete documentation index at: https://docs.flowapt.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Instagram API

> Send Instagram messages, read conversations and receive events through the FlowIQ API.

<Note>
  These Instagram endpoints and webhook events are prepared for rollout and are not yet deployed.
</Note>

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](/flowiq-api-reference/endpoint/instagram-conversations) to list contacts and obtain their IDs.

## Messages and history

| Endpoint | Purpose |
| - | - |
| `POST /send-instagram` | Send [text](/flowiq-api-reference/endpoint/send-instagram-text), [images](/flowiq-api-reference/endpoint/send-instagram-image), [video](/flowiq-api-reference/endpoint/send-instagram-video) or [audio](/flowiq-api-reference/endpoint/send-instagram-audio) |
| `GET /instagram-conversations` | Read Instagram messages, list contacts or find a contact |
| `GET /conversations?platform=instagram` | Alias for the Instagram conversations endpoint |

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"`:

```bash theme={null}
curl -X POST "https://api.flowiq.live/set-webhooks" \
  -H "Authorization: Bearer fiq_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://your-server.com/webhooks/instagram",
    "platform": "instagram",
    "type": "all",
    "secret": "a-long-random-signing-secret"
  }'
```

Receive incoming messages, outgoing content, send confirmations and recorded receipt changes. [Instagram Events](/flowiq-api-reference/webhooks#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](/flowiq-api-reference/endpoint/create-webhook), [List Webhooks](/flowiq-api-reference/endpoint/get-webhooks) and [Delete Webhook](/flowiq-api-reference/endpoint/delete-webhook).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.