Skip to main content
POST
Send Instagram Text
Send a text 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. Instagram permissions and messaging windows still apply. Eligible replies to a recent comment can use the inbox sender’s private-reply fallback.

Reply to a specific message

Add reply_to_message_id to quote an earlier message, the way a person swipes to reply in Instagram. The customer sees the quoted message above your reply.
  • Use the message’s id or its instagram_message_id, both returned by Instagram Conversations and by Instagram webhooks. You can quote the customer’s messages or your own.
  • The message must belong to this conversation, otherwise the request is refused with 400 and nothing is sent.
  • The response says "quoted": true when the customer sees the quote. It is false when Instagram cannot quote that message (for example a comment rather than a direct message), or when your account is connected to FlowIQ through a partner inbox rather than directly to Instagram. The reply is still sent, without the quote.
  • Works the same for image, video and audio messages.

Response

Success (200)

message_id is the Instagram message ID. quoted is true only for a reply sent with reply_to_message_id that the customer sees as a quote. 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
text
string
required

Required for text messages

Required string length: 1 - 1000
instagram_id
string

Instagram-scoped recipient ID as a string

message_type
enum<string>
default:text
Available options:
text
reply_to_message_id
string

Optional. Quote an earlier message in this conversation: its FlowIQ message id or its instagram_message_id (both returned by GET /instagram-conversations and by webhooks). On accounts connected directly to Instagram the customer sees the quoted message above your reply. On accounts connected through a partner inbox the message is sent without the quote (quoted: false). A message that is not in this conversation is refused with 400.

Maximum string length: 200

Response

Message accepted

success
boolean
message_id
string | null

Instagram message ID

recipient_id
string
message_type
string
quoted
boolean

true when the customer sees the quote. false when no reply_to_message_id was sent, or when Instagram could not quote that message (the reply was still sent, without the quote).

contact
object