send_instagram_dm
Send Instagram Direct Messages by IGSID with text, images, audio, video, or PDF files, and reply to a specific message for threaded conversations.
Instructions
Send a Direct Message (text, image, audio/voice, or PDF/file) to an Instagram user by their IGSID. Supports quoting/replying to an exact message (threaded reply). For audio, supported formats are AAC, M4A, WAV, or MP4 up to 25MB.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"recipient_id": "<recipient_id>"
},
"name": "send_instagram_dm"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| message_text | No | Text message to send. | |
| recipient_id | Yes | Instagram Scoped User ID (IGSID). | |
| attachment_id | No | Reusable attachment ID (obtained from upload_reusable_attachment or previous message). If provided, attachment_url is ignored. | |
| attachment_url | No | Public direct URL to the attachment file (PDF, audio M4A/WAV/AAC, image JPG/PNG, MP4 video). Direct raw URL without redirects. | |
| attachment_type | No | Type of attachment: "image", "audio" (voice note), "video", or "file" (PDF/docs). | |
| reply_to_message_id | No | Optional Message ID (mid) of a specific message to quote and reply to (exact message threaded reply). |