Skip to main content
POST
Send Instagram Image
These Instagram endpoints are prepared for rollout and are not yet deployed.
Send an image message to an existing Instagram contact. Use the same organization fiq_ API key as WhatsApp.

Basic Usage

Request Body

Use a contact belonging to the API key’s organization. A username or phone number cannot replace instagram_id. If both identifiers are supplied, they must refer to the same contact. Find an ID with Instagram Conversations. Keep the source URL available: FlowIQ stores that URL in the inbox. Send a caption separately using Send Instagram Text; a combined caption and media request is rejected.

Response

Success (200)

message_id is the Instagram message ID. Success means Instagram accepted the message; delivery and read receipts arrive separately when recorded.

Errors

Errors include success: false and an error string. Invalid input returns 400, an invalid or expired key returns 401, and an unknown contact returns 404. 502 or 504 can mean the send outcome is unknown. Read the conversation before retrying; the sender does not retry automatically.

Webhook Events

Register platform: "instagram" on Create Webhook. See Instagram event payloads, delivery authentication and signing.

Authorizations

Authorization
string
header
required

Your FlowIQ API key (from Settings → Profile → API Keys), sent as a bearer token. Format: Bearer fiq_YOUR_API_KEY

Body

application/json
contact_id
string<uuid>
required
message_type
enum<string>
required
Available options:
image
media_url
string<uri>
required

Required for media: publicly accessible HTTPS URL. Keep the source available; the inbox stores this URL.

instagram_id
string

Instagram-scoped recipient ID as a string

Response

Message accepted

success
boolean
message_id
string | null

Instagram message ID

recipient_id
string
message_type
string
contact
object