Post to Instagram from Cursor

How it works

1. Cursor calls list_channels to find your Instagram channel.
2. It calls get_channel_rules to learn the Instagram limit, media needs and settings.
3. It writes the post and runs check_post, which returns any rule problems.
4. It picks a time with find_free_slot if you did not give one, shows you the post, and calls schedule_post after you say yes.

Instagram rules Cursor follows

• Every post needs at least 1 photo or video. Upload it first with upload_media_from_url.
• Up to 2,200 characters and 30 hashtags. Carousels take up to 10 items.
• Photos must have a ratio between 4:5 and 1.91:1.
• A Reel needs exactly 1 video. Stories are posted without the caption.

Rule summary from the Instagram connector: Needs at least 1 photo or video. Max 2200 characters, max 30 hashtags. Up to 10 items in a carousel. Photos must be JPEG with a ratio between 4:5 and 1.91:1. Follow-up comments are posted as comments (text only).

Rule summary from the Instagram connector: For Business or Creator accounts that sign in with Instagram. No Facebook Page needed. Needs at least 1 photo or video. Max 2200 characters, max 30 hashtags. Up to 10 items in a carousel. Photos must be JPEG with a ratio between 4:5 and 1.91:1. Follow-up comments are posted as comments (text only).

Instagram settings the agent can use

These go in channels[].settings of schedule_post. Cursor learns them from get_channel_rules, so you can just describe what you want.

Instagram works with both sign-in types: a Business or Creator account through Facebook, or Instagram login without a Facebook Page. The rules are the same.

Example prompts for Instagram

• "Upload this image URL and schedule it as an Instagram post tomorrow at 19:00 with a caption and 10 relevant hashtags."
• "Make a carousel from these 5 photo links, with a caption that tells the story in order."
• "Post this video as a Reel and add @partnerbrand as a collaborator."
• "Which Instagram posts had the most reach this month?"
• "Write an Instagram caption for docs/launch.png that explains the new feature in plain words."

How Cursor handles Instagram

Cursor sits next to your code, so Instagram posts can come straight from your work: a pull request, a changelog, a README or release notes. Ask the agent to read the file, write Instagram posts, carousels, Reels and Stories for your users rather than for developers, run check_post, and save it as a draft for someone on the marketing side to finish. Keep the Postozo API key or sign-in in Cursor's MCP settings, never in the repository.

More prompts in Cursor's style

• "Read CHANGELOG.md and write an Instagram post about the newest release for our users, then save it as a draft."
• "Look at the last merged pull request and write a short Instagram post that explains what changed and why it helps."
• "Find a free Instagram slot this week with find_free_slot and schedule the release note there."

Before Cursor schedules an Instagram post

• The channel is connected in Postozo and shows in list_channels.
• The post has at least 1 picture or video, uploaded with upload_media_from_url.
• You have seen the text, the time and the channel, and said yes.

What the call looks like

You never have to write this yourself. It shows what Cursor sends to schedule_post for Instagram, with real setting keys:

{
  "type": "schedule",
  "date": "2026-10-01T09:30:00+05:30",
  "content": "Your Instagram text",
  "media": [
    "MEDIA_ID"
  ],
  "channels": [
    {
      "channelId": "YOUR_INSTAGRAM_CHANNEL_ID",
      "settings": {
        "format": "Reel",
        "collab": "@partnerbrand"
      }
    }
  ],
  "thread": [
    {
      "content": "First comment",
      "delay": 5
    }
  ]
}

Set up Cursor

Add Postozo to Cursor with a few lines of JSON. Then let Cursor's agent write launch posts from your code, docs and release notes, and schedule them. Connection: an API key header. Full steps are on the Cursor setup page. Your Instagram account must be connected in Postozo first: see the Instagram scheduler.

Also works with Claude and ChatGPT.

Tips for Instagram posts written with Cursor

• Tell Cursor who the post is for and what you want people to do. "Write an Instagram post for small shop owners that asks them to book a demo" works better than "write a post".
• Start the chat with a few lines about your tone and the words to use or avoid. Cursor writes the text itself, so it needs this to sound like you.
• Ask for 2 or 3 versions and pick 1. It is faster than asking for changes 5 times.
• Say "save as drafts" when you want to check the posts on the calendar before they are scheduled.
• Add 1 detail only you know, like a real number from your business or a customer question. It makes the post yours.