Instagram Developer API and DM automation: plans, endpoints and limits

By ChatVerse · Updated

ChatVerse offers Instagram DM automation in the app and an Instagram Developer API for your own code. The API includes 10,000 calls a month on Growth (₹499), 50,000 on Pro (₹999) and 2,00,000 on Business (₹1,799); the Starter plan (₹99) has no API. You authenticate with a Bearer key from your Instagram Studio and call it from your server.

Instagram DM automation without code

Most people start with the app. Instagram automation on ChatVerse works with professional accounts (business or creator) through the official Instagram API. It can auto-reply to comments on posts and reels, send a DM to everyone who comments (optionally only to followers, or only for chosen keywords), answer DMs by keyword, and, from the Growth plan, answer DMs with an AI bot trained on your business. All chats sit in one inbox.

The Instagram Developer API

The Developer API is for teams that want to read or control the same account from their own software. Every call acts on the one Instagram account the key belongs to. The reference is in the Instagram API docs.

Authentication

Turn on Developer Mode in your Instagram Studio, under Settings, to get an API key (it starts with cvk_ig_live_; WhatsApp keys do not work here). Send it as a Bearer token in the Authorization header, from your server. Browser requests with an Origin header are refused with 403.

curl -X GET 'https://api.chatverse.io/v1/instagram/health' \
  -H 'Authorization: Bearer YOUR_API_KEY'

The health call confirms the key and returns the Instagram account it acts on.

Main endpoints

  • GET /v1/instagram/automations lists your automations; PATCH turns one on (ACTIVE) or off (PAUSED); DELETE removes it.
  • POST /v1/instagram/messages sends a DM (text up to 1,000 characters). It returns 502 SEND_FAILED when Instagram refuses it, usually because the 24-hour window has closed.
  • GET /v1/instagram/conversations and /v1/instagram/conversations/{conversation_id}/messages read your chats.
  • /v1/instagram/bot/paused lets you stop the AI bot answering one customer and let it answer again, for a hand-off to a person.
  • GET /v1/instagram/insights, /v1/instagram/automation-impact and /v1/instagram/top-posts return profile numbers, what the automations did and your best posts.

Limits by plan

Each account can make 120 requests a minute, and 10 a minute for sending DMs. The monthly allowance runs on the UTC calendar month:

  • Starter (₹99 a month): no Developer API.
  • Growth (₹499 a month): 10,000 calls a month.
  • Pro (₹999 a month): 50,000 calls a month.
  • Business (₹1,799 a month): 2,00,000 calls a month.

A plan without the API returns 402 PLAN_REQUIRED. Going over a limit returns 429 with RATE_LIMITED or QUOTA_EXCEEDED; wait or retry with backoff. See all plans on the Instagram pricing page and the rate limits docs.

Using WhatsApp too

The WhatsApp side has its own API with the same style of keys and limits. Read the WhatsApp Business API for developers guide, or WhatsApp automation for business for the no-code tools.

Questions

How many Instagram API calls does Growth include?
The Growth plan (₹499 a month) includes 10,000 Developer API calls a month. Pro includes 50,000 and Business 2,00,000. Starter has none.
Can I send a DM with the API?
Yes, with POST /v1/instagram/messages, up to 1,000 characters per message. Instagram usually refuses it once the 24-hour window since the customer’s last message has closed.
Does the key work from a browser?
No. Call the API from your server. Requests that carry a browser Origin header are refused with 403.
Which accounts work?
Instagram professional accounts, meaning business or creator accounts, connected through the official Instagram API.

More guides