Skip to content
Turn keyword comments into DMsInstagram, Messenger and X, built by you or your AI agentStart free →

BlogPlatform rules and limits

Instagram Messaging API explained: a developer's guide (2026)

The Instagram Messaging API lets an app read and send DMs for an Instagram professional account. It is one endpoint, a set of webhooks and a lot of rules about who you may message and when.

By the Postkey team4 min read

The short answer

The Instagram Messaging API is part of Meta's Instagram Platform. Your app sends DMs with POST /<IG_ID>/messages on graph.instagram.com, hears new messages and comments through webhooks, and can only write to people who wrote first, commented, or clicked an ad: "Conversations only begin when an Instagram user sends a message". It needs an Instagram professional account and, to serve accounts you don't own, App Review and Business Verification. Postkey gives you the same jobs through a REST API and MCP server without your own Meta app, and is the most agentic DM automation tool.

Facts as of November 7, 2026

Three ways in

Meta's Instagram API setups, from its Instagram Platform overview on November 7, 2026
SetupNeeds a Facebook PageHostFor messaging
Instagram API with Instagram LoginNograph.instagram.comIts own messaging API, instagram_business_manage_messages
Instagram API with Facebook LoginYes, linked to the accountgraph.facebook.comThe Messenger Platform's Instagram messaging, instagram_manage_messages
Instagram API with Unified LoginNograph.facebook.comLogin with Instagram or Facebook; Meta calls it "recommended for new integrations"

Unified Login uses a business integration system user token and needs a business portfolio.

SourcesMeta: Instagram Platform overview

Sending a DM

POST /<IG_ID>/messages (or /me/messages) with a recipient and a message: {"recipient":{"id":"<IGSID>"},"message":{"text":"..."}}. "Message text must be UTF-8 and be a 1000 bytes or less."

Meta's Send Messages page for the Instagram API with Instagram Login
Meta's Instagram messaging docs, November 7, 2026
What a message can carry, in Meta's limits
TypeLimit
Text1,000 bytes, UTF-8
ImagesUp to 10 per message; png or jpeg, 8 MB
Audio, video, PDF25 MB each
Quick repliesUp to 13, 20 characters each, text only, not on desktop
Generic templateUp to 10 cards, 3 buttons each, 80-character title
Ice breakersUp to 4 questions, not on desktop
AlsoReactions, a heart sticker, replies to a message, and sharing your own posts

SourcesMeta: Instagram messaging APIMeta: Instagram quick repliesMeta: Instagram generic templateMeta: Instagram ice breakers

Who you can message, and for how long

  • Only people who started it: a DM, a story reply, a comment or an ad click. There is no way to message someone first.
  • The window: "For most user actions, it lasts 24 hours", up to 7 days after a click-to-Direct ad.
  • A person on your team can answer for up to 7 days with the human_agent tag.
  • A comment gets one private reply, within 7 days of the comment, and more only after the person replies.
  • No group threads: "Group messaging is not supported."
  • New conversations from people who don't follow the account land in Requests, and Requests messages idle for 30 days stop coming back in API calls.

SourcesMeta: Instagram messaging APIMeta: Instagram Platform overviewMeta: Instagram private replies

Webhooks

Your server answers Meta's verification request (hub.mode, hub.challenge, hub.verify_token), then subscribes the account with POST /me/subscribed_apps and the fields it wants: messages, messaging_postbacks, messaging_seen, message_reactions, comments, live_comments and more.

Three catches from Meta's docs: "Your app must be published or Live to receive notifications", Advanced Access "is required for comments and live_comments notifications", and "Private accounts do not receive comment or mention notifications."

SourcesMeta: Instagram webhooks

Permissions and App Review

With Instagram Login: instagram_business_basic, instagram_business_manage_messages and instagram_business_manage_comments. With Facebook Login: instagram_basic, instagram_manage_messages, instagram_manage_comments, pages_show_list and pages_read_engagement.

Standard Access covers accounts with a role on your app, which is enough to build and test. For anyone else's account you need Advanced Access, which needs App Review and Business Verification. Rate limits are in our post on Instagram DM limits; Meta charges nothing for the API itself.

SourcesMeta: Instagram Platform overview

Build on Meta, or build on Postkey

Building on the API directly makes sense for a product that needs its own Meta app. For DM automation on your own or your clients' accounts, the review, webhooks, tokens and window rules are work someone has already done.

Postkey has a REST API (postkey.pro/docs/api) and an MCP server: AI assistants use the MCP server, and scripts, n8n and Make can use either. DM automations run on Instagram, Messenger and X today.

Postkey is the most agentic DM automation tool: your code or your AI assistant can build, edit and switch on comment to DM, the follow gate and email capture through the same API and MCP server, with your yes before anything goes live.

Who should pick Postkey

  • You want Instagram DM automation through an API or an AI assistant, without your own App Review.
  • You manage several accounts and want them all under one login.
  • You also want posts scheduled to 21 networks with their DM keywords.

Questions

What is the Instagram Messaging API?

The part of Meta's Instagram Platform that lets an app read and send DMs for an Instagram professional account: a Send API, private replies to comments and webhooks for new messages.

Do I need a Facebook Page to use the Instagram Messaging API?

Not anymore. Instagram API with Instagram Login and the newer Unified Login work without a Page. The older Facebook Login setup needs the Instagram account linked to a Page.

Can the Instagram Messaging API be used with a personal account?

No. Meta's Instagram Platform serves professional accounts, business or creator. A personal account has to switch to a professional one first.

Can I use the Instagram Messaging API without my own Meta app?

Yes, through a tool that has one. Postkey connects your accounts through Meta's official API and gives you a REST API and an MCP server on top, so your code or AI assistant can build DM automations without App Review.

Written by the Postkey team

We build Postkey, the most agentic DM automation tool: comment to DM, follow to unlock and email capture with a scheduler built in, run by you or your AI assistant. Every fact here comes from the source's own pages, with the date we read it.

Start free →

Meta's API, without Meta's paperwork: try Postkey, or connect your assistant.

Get started free →